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Chapter 1 . Introduction 



DSSSL (Document Style Semantics and Specification Language) is an ISO standard 
(ISO/IEC 10179:1996) published in the year 1996. 

DSSSL is a standard of the SGML family (Standard Generalized Markup Language, 
ISO 8879:1986), whose aim is to establish a processing model for SGML documents. 
For a good understanding of the SGML standard, many books exist including Author’s 
guide[Bryanl988] and The SGML handbook[Goldfarbl990]. 

A DSSSL document is an SGML document, written with the same rules that guide any 
SGML document. The structure of a DSSSL document is explained in Chapter 2. 

DSSSL is based, in part, on scheme, a standard functional programming language. The 
DSSSL subset of scheme along with the procedures supported by DSSSL are explained 
in Chapter 3. 

The DSSSL standard starts with the supposition of a pre-existing SGML document, 
and offers a series of processes that can be performed on it: 

• Groves 

The first process that is performed on an SGML document in DSSSL is always the 
analysis of the document and the creation of a grove. 

The DSSSL standard shares many common characteristics with another standard of 
the SGML family, HyTime (ISO/IEC 10744). These standards were developed in 
parallel, and their developers designed a common data model, the grove, that would 
support the processing needs of each standard. 

Groves are the cornerstone of the cohesion between DSSSL and HyTime. Groves are 
an abstract data model for the representation of information contained in SGML doc- 
uments. They also permit the manipulation of this information. They are explained 
in Chapter 4. 
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• Transformation 

DSSSL offers a set of procedures capable of transforming the structure of an SGML 
document. In fact, transformations are not limited to documents, but operate on the 
internal representation of those documents in form of a grove. The result of the trans- 
formation is converted into a SGML document. The transformation process allows 
the addition of new information to the grove, deletion of parts of the grove, or mod- 
ification of the structure and order of the parts of the grove, giving as result a grove 
that can differ greatly from the input. The transformation process is explained in 
Chapter 6. 

• Formatting 

SGML is a standard oriented to the structural and semantic mark-up of information 
in documents. Although mark-up is important for information management, another 
important aspect in the processing of a document is the generation of something 
readable that can transmit ideas to a potential reader. Format and typography play 
an important role in enhancing the legibility of a document by distinguishing parts 
of the text from one another. DSSSL offers one of the most powerful and versatile 
solutions for the formatting of SGML documents. It is explained in Chapter 7. 

• Query 

DSSSL defines a query language capable of searching and finding information in a 
grove. This is equivalent to treating a SGML document as though it were a database. 
This component is used as much for performing transformations as for giving style 
to a document. Although it is not offered as a standalone component, the query com- 
ponent has interest on its own, and could well be used for complex queries outside 
of transformation and style processes. It is explained in Chapter 5. 

Figure 1-1. DSSSL conceptual model 




Source Result Output of 

Document Document Formatter 



The above diagram shows the components of the DSSSL processing model. The shaded 
areas indicate the components that are standardized by DSSSL. DSSSL also defines a 
programming language that can be used for all these processes in a uniform way. 
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This book is an explanation of the DSSSL standard, but it is not intended as a substitute. 
DSSSL is a text easy to read if it is compared to other standards. This book explains 
all the aspects covered by DSSSL, but for a detailed explanation of concrete aspects, 
it will still be necessary to rely on the text of the standard. The only intention of this 
book is to explain in a didactic way what the standard explains in a more rigurous and 
formal way. 




Chapter 2. The DSSSL 
Specification 



A DSSSL document is an SGML document, and follows the usual mark-up rules 
of SGML. More specifically, a DSSSL document follows the structure of the 
dsssl- specification architectural form. A DSSSL specification is what is 
called an "architectural form", defined by a meta-dtd. 

2.1. Architectural Forms 

The concept of an architectural form was introduced by the HyTime standard in the 
Architectural Form Definition Requirements clause. 

An architecture is a class of document types with similar structure. It is a way of defin- 
ing a hierarchy at the level of document structure. An architecture defines a general 
document architecture, and afterwards, document types can specify that some of their 
elements correspond with the ones defined in the architecture. The interesting point of 
architectures is that they are defined with the usual methods of document type defini- 
tions, and thus, any document type is in itself an architecture. 



2.2. The DSSSL Architectural Form 

Below the DSSSL architecture (or the DSSSL DTD which is the same thing) is ex- 
panded. When a DSSSL document is written, the desired elements will be chosen. 

<!DOCTYPE dsssl-specif ication PUBLIC 

"ISO/IEC 10179 : 1996//DTD DSSSL Architecture / /EN" [ 

<?IS10744 ArcBase DSSSL> 
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<! ENTITY % DSSSLDTD PUBLIC 
"ISO/IEC 10179 :1996//DTD DSSSL Architecture/ /EN" > 



<! NOTATION DSSSL 

PUBLIC "ISO/IEC 10179 : 1996//NOTATION DSSSL 

Architecture Definition Document / /EN" 

-- A document architecture conforming to the 
Architectural Form Definition 
Requirements of ISO/IEC 10744. --> 

<!ATTLIST #NOTATION DSSSL 

-- Support attributes for all architectures -- 
ArcQuant CDATA #FIXED "NAMELEN 64" 

ArcDTD CDATA #FIXED "%DSSSLDTD" 

ArcDocF NAME #FIXED dsssl-speci f ication 
ArcDataF NAME #FIXED dsssl-specif ication> 



]> 

<DSSSL-SPECIFICATION> 

<!-- HERE DECLARATIONS MAY BE INCLUDED --> 

<!-- START OF GLOBAL DECLARATIONS --> 

<BASESET-ENCODING 

<LITERAL-DESCRIBED-CHAR 

< ADD -NAME - CHARS 

<ADD- SEPARATOR-CHARS 

< STANDARD - CHARS 

<OTHER-CHARS 

< COMBINE -CHAR 

<MAP - SDATA- ENT I T Y 

<CHAR-REPERTOIRE 

< FEATURES 

< SGML - GROVE - PLAN 

<!-_ end of global declarations --> 

< EXTERNAL - S PEC I F I CAT I ON 
<STYLE-SPECIFICATION 

<!-- LOCAL DECLARATIONS: SAME AS GLOBAL ONES --> 

< STYLE - S PEC I F I CAT I ON- BODY 

<!-- STYLE LANGUAGE EXPRESSIONS --> 

<!-- unit-declaration --> 

(def ine-unit 

<!-- definition --> 

(define 

<!-- construction-rules --> 

(query 

(id 

(element 

(default 

(root 

<!-- mode-construction-rule-group --> 

(mode 

<!-- application-flow-object-class-declaration --> 

(declare-f low-obj ect-class 

<!-- application-characteristic-declaration --> 

(declare -characteristic 

<!-- application-char-characteristic+property-declaration --> 

(declare-char-characteristic+property 

<!-- initial-value-declaration --> 

(declare- initial -value 

<!-- reference-value-type-declaration --> 
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(declare- reference -value- type 
<!-- page-model-definition --> 

(define -page -model 

<!-- column-set-model-definition --> 

(define -column- set -model 

<!-- added-char-properties-declaration --> 
(add-char-properties 

<!-- character-property-declaration --> 

(declare-char-property 

<!-- language-definition --> 

( de f ine - 1 anguage 

<!-- default-language-declaration --> 

( dec lare-de fault -language 
</STYLE-SPECIFICATION-BODY> 
</STYLE-SPECIFICATION> 

< TRANSFORMAT I ON- S PEC I F I C AT I ON 

<!-- LOCAL DECLARATIONS: SAME AS GLOBAL ONES --> 
<TRANSFORMAT I ON- SPECIFICATION- BODY 

<!-- TRANSFORMATION LANGUAGE EXPRESSIONS --> 
<!-- unit-declaration --> (define-unit 

<!-- added-char-properties-declaration --> 
(add-char-properties 

<!-- character-property-declaration --> 
(declare-char-property 

<!-- transliteration-map-definition --> 

( de fine - 1 rans 1 i terat ion-map 
<!-- language-definition --> 

( de f ine - 1 anguage 

<!-- default-language-declaration --> 

(dec lare-de fault- language 
<!-- definition --> 

(define 

<!-- association --> 

(=> 

< / TRANSF ORMAT I ON - S PEC I F I C AT I ON - BODY> 

</ TRANS FORMAT I ON- S PEC I F I CAT I ON> 

< /DSSSL-SPECIFICATION> 



2.3. Features 

The features needed by the processor to execute the stylesheet definitions are declared 
in the features element. The following sections describe the features available to 
transformation and formatting stylesheets. 

2.3.1. Transformation Specification Features 

From the existing features, the following are allowed in transformation specifications. 

• combine-char: allows the combine -char element type form. See Section 2.4. 

• keyword: allows #!key in procedure argument definitions. See Section 3.3.4. 

• multi-source: allows the use of the transform- grove procedure. See Section 6.5.2. 

• multi-result: allows the generation of multiple result groves. See Chapter 6. 
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• regexp: allows the use of node regular expressions. See Section 5.4.8.2. 

• word: allows the use of the word searching facilities. See Section 5.4.8. 1. 

• hytime: allows the use of HyTime facilities for linking. Not covered in this book 

• charset: allows the use of the element type forms base -set -encoding, 

literal -described-char, add-name- chars, 

add-separator-chars, standard-chars, other-chars and 

map-sdata-entity. See Section 2.4. 

2.3.2. Style Specification Features 

From the existing features, the following are allowed in style specifications. 

• expression: allows the use of the full expression language. See Chapter 3. Otherwise 
only the core query language may be used. See Section 3.6. 

• multi-process: allows unrestricted use of process-children. See Section 7.2.9. 

• query: allows the use of the full query language. See Chapter 5. Otherwise 
only the core query language may be used. See Section 5.4.6. It implies the 
multi -process feature. 

• regexp: allows the use of node regular expressions. See Section 5. 4. 8. 2. 

• word: allows the use of facilities for word searching. See Section 5.4.8. 1. 

• hytime: allows the use of facilities for HyTime location addressing. Not covered in 
this book. 

• combine-char: allows the combine -char element type form. See Section 2.4. 

• keyword: allows #!key in argument definitions. See Section 3.3.4. 

• side-by-side: allows the use of the side-by-side and side-by-side-item 
flow object classes. See Section 7.3.6. 

• sideline: allows the use of the sideline flow object class. See Section 7.3.8. 

• aligned-column: allows the use of the aligned-column flow object class. See 
Section 7.3.21. 

• bidi: allows the use of the right- to-left writing-mode and the embedded- text flow 
object class. See Section 7.3.18 and Section 7.3.1. 

• vertical: allows the use of the top-to-bottom writing-mode. See Section 7.3.1. 

• math: allows the use of classes for mathematical formulae. See Section 7.3.24. 

• table: allows the use of flow objects for table formatting. See Section 7.3.7. 

• table-auto- width: allows the automatic computation of table column widths. See Sec- 
tion 1.3.1. 3. Implies the table feature. 

• simple-page: allows the use of the facilities for simple page layout. See Section 7.3.2. 

• page: allows the use of page -sequence and column- set -sequence flow 
object classes. See Section 7.3.3. 
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• multi-column: allows the use of column-sets containing more than one column. See 
Section 133.2. Implies the page feature. 

• nested-column: allows the use of column-set-sequence with a column-set-sequence 
ancestor. See Section 7. 3. 3. 2. Implies the multicolumn and page features. 

• general-indirect: allows the use of the general-indirect-sosofo procedure. See Sec- 
tion 7. 3. 3.4.1. 

• inline-note: allows the use of the inline-note flow object class. See Section 
7.3.22. 

• glyph-annotation: allows the use of the glyph-annotation flow object class. 
See Section 7.3.11. 

• emphasizing-mark: allows the use of the emphasizing-mark flow object class. 
See Section 7.3.23. 

• included-container: allows the use of the included-container-area flow ob- 
ject class. See Section 7.3.15. 

• actual-characteristic: allows the use of actual-c for each inherited characteristic c. 
See Section 7.2.13. 

• online: allows the use of facilities for online formatting. See Section 7.3.25. 

• font-info: allows the use of ihQ font-property procedure. See Section 7.2. 18. 

• cross-reference: allows the use of the process-element-with-id. See Section 7.2.9. 

• charset: allows the use of the base-set-encoding, 

literal -described-char, add-name-chars, 

add-separator-chars, standard-chars, other-chars, 

map-sdata-entity. See Section 2.4. 

2.4. Character Repertoires 

The char-repertoire element allows the definition of the character repertoire. 

Example 2-1. Char-repertoire 

<char-repertoire name= " repertoire " > 

The use of char -repertoire is equivalent to a sequence of instances of 
baseset-encoding, literal-described-char, add-name-chars, 
add-separator-chars, standard-chars, other-chars, 

map-sdata-entity elements and of character-property-declaration and 
added-char-properties -declaration expressions. 

When no repertoire is available, a set of definitions allows the custom specification of 
one. 

The standard-chars element type form gives names to characters in ISO/IEC 
10646-1 or ISO/IEC 6429, which are identified by their universal code. The content 
shall be a list of pairs of character names and universal codes, and associates the names 
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with the codes. There is a set of universal codes that must be declared when this element 
type form is used. The example below shows the required universal codes. 

Example 2-2. Standard-chars 

<standard-chars> 

<!-- mandatory characters from ISO/IEC 10646-1 --> 

32 space 

34 quotation-mark 

35 number- sign 

39 apostrophe 

40 left-parenthesis 

41 right-parenthesis 

42 asterisk 

43 plus-sign 

4 5 hyphen -minus 

46 full-stop 

47 solidus 

48 digit-zero 

49 digit-one 

50 digit-two 

51 digit-three 

52 digit-four 

53 digit-five 

54 digit-six 

55 digit-seven 

56 digit-eight 

57 digit-nine 

58 colon 

59 semicolon 

60 less-than-sign 

61 equals-sign 

62 greater-than-sign 

63 question-mark 
65-90 A-Z 

92 reverse-solidus 
97-122 a-z 

<!-- mandatory characters from ISO/IEC 6429 --> 

10 line-feed 
13 carriage-return 
< / s tandard-chars> 

The other-chars element type form declares the names of characters in the char- 
acter repertoire which do not correspond to characters defined in ISO/IEC 10646-1 or 
ISO/IEC 6429. The content shall be a list of character names. 

Example 2-3. Other-chars 

<other-chars>logo-SGML runic-f runic-u</other-chars> 

The baseset -encoding element type form specifies how bit combinations in an 
SGML document, whose meaning was declared in the SGML declaration to be that of 
a character number in a base character set, are to be converted to characters. 
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Example 2-4. Baseset-encoding 

<baseset-encoding>31 runic- f</baseset-encoding> 

The literal -described-char element type form specifies that bit combinations 
in an SGML document, whose meaning was declared in the SGML declaration using 
a minimum literal equal to the value of the desc attribute, are to be converted to the 
character whose name is specified in the content of the element. 

Example 2-5, Literal-described-char 

<literal-described-char desc="SGML User's Group logo"> 
logoSGML 

</literal-described-char> 

The map -sdata- entity element type form declares that a reference to an inter- 
nal SDATA entity, whose name is equal to the value of the name attribute or whose 
replacement text is equal to the value of the text attribute, represents the character 
whose name is given in the content of the element. The content of the element shall be 
a single character name. 

Example 2-6. Map-sdata-entity 

<map-sdata-entity name="Alpha" text= " [Alpha] " > 
greekA 

< /map -sdata-enti ty > 

<map-sdata-entity name= "V. Beta" text=" [V.Beta] "> 
greekB 

</map-sdata-entity> 

The add- separator-chars element type form declares characters as separators 
allowed in whitespace in the DSSSL transformation and style languages. 

The add-name -chars element type form declares additional characters to be used 
in identifiers in the DSSSL transformation and style languages. 

The combine -char element type form contains a list of three or more character 
names. It declares that a sequence of characters comprising the second and following 
characters shall be replaced by the first character. Use of this element type form requires 
the combine-char feature. 



2.5. SGML Grove Plan 

The sgml -grove-plan element allows the specification of the modules of the 
SGML property set to be included, thus choosing a view of the complete grove. 
Groves are explained in Chapter 4. 

In the transformation specification baseabs, prlgabsO, instabs and prlgabsl modules are 
automatically included. 

In the style specification baseabs, prlgabsO and instabs modules are automatically in- 
cluded. 
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Example 2-7. Sgml-grove-plan 

<sgml-grove-plan modadd= " sdclsds dtgabs"> 



2.6. External Specification 

The external -specification element allows the use of a specification stored 
in another sgml document. 

Example 2-8. External-specification 

<! ENTITY otherspec SYSTEM " file . sgml " > 

< EXTERNAL -SPECIFICATION ID="Xl" DOCUMENT^ " Otherspec " > 



2.7. Stylesheet Partitioning 

Given a DSSSL specification, it is sometimes necessary to modify parts of the rules 
governing the process. Let us imagine some general purpose DTD, with a standard set 
of rules for transformation and style. These rules provide a standardized aspect to doc- 
uments. But for some concrete document the standard formatting may be inadequate. 
Even when the standard processing is acceptable, a general purpose environment will 
depend on user specified parameters. DSSSL allows this with a partitioning and refer- 
encing mechanism. 

A specification may be partitioned. Each part is a separate specification in its 
own right. Parts can refer to other parts, and a priority mechanism governs the 
application of rules; the referenced parts have lesser precedence than the referencing 
ones. This allows redefinition of procedures and reuse of code. In order to refer to 
other parts, the ID/IDREF mechanism is used. Each style- specification, 
transformation-specification and external-specification is a 
part. It is an error when a single part contains conflicting declarations. In case two 
parts have conflicts, the declaration in the earlier part takes precedence. 

Example 2-9. Customization 

<STYLE-SPECIFICATION ID="S1" USE="X1"> 

<!-- first Style part imports rules of second one, but 
first part rules take precedence in case of conflict --> 
<STYLE-SPECIFICATION ID="S2" USE="S1"> 

<!-- second style part imports rules of external one, but 
its rules take precedence in case of conflict --> 

< EXTERNAL -SPECIFICATION ID="Xl" DOCUMENT= " Otherspec " > 

<!-- external specification part imports all parts 
(style, formatting and external) 
specified in the referenced document 

it is not used unless referenced in a local part with use 
when referenced, all external parts are active --> 
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3.1 . Introduction 

DSSSL specifies a programming language based on Scheme [Dybvigl996], a standard 
functional programming language. The two languages differ in some ways but these 
differences are not relevant to this book. DSSSL is a small and exceptionally clear 
language, designed to have just a few regular constructions that can be composed easily. 
It follows a formal mathematical model, the lambda calculus. 

Summarizing in a few words, it can be said that DSSSL is “a statically scoped expres- 
sion language with block structure where types are associated to values. Evaluation is 
strict and parameter passing is by value. Implementations are required to be properly 
tail-recursive”. The rest of this chapter will explai the above phrase point by point, 
while the necessary notions are given to use the language. 

3.2. Expressions 

An expression language is a language that only manages expressions. An expression is 
a construct that returns a value. Everything that one can write using the DSSSL pro- 
gramming language is an expression. There are only five kinds of expression: literals, 
variables, lambda, procedure call and conditional. As has already been pointed out, it 
is a small language with few constructions. 
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3.2.1. Literals 

Literals are self-evaluating expressions. If an expression is that which returns a value, 
a literal directly represents a value. It is the most basic type of expression. 

Example 3-1. Literal 

5 is a literal that self- evaluates itself to the numeric quantity five. 

3.2.2. Lambda Expressions 

The underlying formal mathematical model of the expression language is the lambda 
calculus, as was explained in the introduction. We are not going to enter into a detailed 
explanation of the lambda calculus model, as this is not the aim of the book. However, 
a quick introduction to a few concepts will be helpful before entering into the use that 
DSSSL makes of the lambda calculus. 

In the lambda calculus, everything is a lambda expression. A lambda expression is a 
way to codify what is usually called a function or procedure. Example 3-2 shows the 
aspect a lambda expression has. 

Example 3-2. A Lambda Expression 

Ax.y 

where x is the parameter of the expression, and y is the calculation performed. 

Thus, for example, in lambda calculus, a constant numeric value would be represented: 



Example 3-3. Constant Lambda Expression 

Ax. 5 

which is interpreted as “given x, return the value 5 as the result”. 

lambda 



(lambda (required-arguments 

#! optional optional-arguments 
#!rest rest-argument 
# ! key keywords ) 
expression) 



lambda is the DSSSL codification of the lambda expression. 

• required-arguments are values necessary for the result of the lambda 
expression. 

• optional -argumen ts are values that can be used for the result, but are not 
necessary for the calculations. Each optional argument may be a variable name 
or a list of two elements, a variable name and an initializer. 
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• rest-argument is one argument that collects all the remaining values after 
the optional ones. 

• keywords are arguments that identify by name rather than by position. Key- 
words are distinguished because they end with :. Each keyword argument may 
be a variable name or a list of two elements, a variable name and an initializer. 

Example 3-4. Complete Argument List in Lambda Expression 

(lambda (x #! optional (y 3) z #!rest v #!key (a: 4)) ...) 

In this lambda expression, there is one required argument, x. There are two op- 
tional arguments, y and z. y has an initializer value of 3 which will be used in 
case the argument is not provided. There is an argument accepting a list of the rest 
of arguments, v. And finally there is a keyword a : with an initializer of 4 which 
will be used in case the keyword is not provided. 

Care must be taken with the use of parentheses. Every opening parenthesis must have 
a matching closing parenthesis. This is an identifying characteristic of the language. 

Returning to Example 3-4, the same constant lambda expression would be written in 
DSSSL: 

Example 3-5. Constant Lambda Expression in DSSSL 

(lambda (x) 5) 

In DSSSL a lambda expression is evaluated to a procedure that, when evaluated (see 
Section 3.2.3) with the adequate parameters, will return the body of the procedure, 
substituting each parameter in the body for the value of the corresponding expression. 

3.2.3. Procedure Application 

A procedure application is represented by enclosing the expressions for the procedure 
to be called and its arguments in parentheses: (procedure parameter^ . . . ) . 

In Section 3.1 evaluation was said to be strict. This means that, before an application 
is executed, all the arguments are evaluated to obtain a value that will be used for the 
internal calculations of the procedure. The language does not permit a parameter to 
have an unknown value, or to be pending on a calculation. Every value needed must be 
obtained before the procedure is called. 

Example 3-6. Procedure Application 

((lambda (x) x) 7) ^ 7 

The expression above is the application of the identity procedure to the value 7. The 
lambda expression has one argument, x, and one parameter, 7. First 7 is evaluated, and 
being a literal, autoevaluates to the quantity 7. Then 7 takes the place of x in the body 
of the argument. The result is the body of the lambda expression, x, whose value is 7 
by way of the argument substitution. 

((lambda (x) 5) 7) — > 5 
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When the constant procedure is applied to parameter 7 in the lambda expression, each 
occurrence of x in the body would be substituted by 7. Evaluation is strict, which means 
that before applying a procedure, all the arguments are evaluated. 7 would be evaluated, 
but being it a literal, it self-evaluates to 7. As there is no occurrence of x in the body, 5 
is returned. 

3.2.4. Some More Complex Procedures 

As in a lambda expression, the body of a procedure is itself an expression, which can 
also be an application. The language is designed so that the basic constructs can be 
combined in any way needed. 

Example 3-7. A Compound Lambda Expression 

(lambda (x) (+ x 1) ) 

This lambda expression defines a procedure that increments by one the value of the 
parameter x. The body of the procedure is an application of the addition function to 
two parameters, x and 1. To evaluate this lambda expression it must be applied to a 
parameter. 

Example 3-8. Parameter Substitution in Applications 

((lambda (x) (+ x 1) ) 7 ) -> (+ 7 1) 8 

In this case, x has been instantiated with the value 7, and the substitution has taken 
place in the body. 

Example 3-9. Multiple Parameter Substitution in Applications 

((lambda (x y) (+ x y) ) 7 8) -^ (+ 7 8) 15 

In this example, given that the lambda expression has two parameters. It has received 
two arguments in the application, 7 corresponds to x, and 8 corresponds to y. 

Example 3-10. Partial Substitution of Multiple Parameters in Applications 

((lambda (x y) (+ x y )) 7) (lambda (y) (+ 7 y) ) 

This example is somewhat more advanced than those above and may cause the reader 
confusion. There is one lambda expression with two formal arguments, but only one 
actual argument is passed in the application. The first formal argument, x, is instantiated 
with the actual parameter, 7. The substitution takes place in the body, and the result is 
a lambda expression with one formal argument. This example is given for two reasons. 
First, to show the reader that the result of evaluating an expression can be any of the 
five types of expressions. Second, to understand the care that must be taken to define 
and evaluate expressions; the resulting type of expression of the returned value should 
always be under control of the programmer so that there are no surprises. 
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Example 3-11. Application with a Full Parameter List 

((lambda (a #! optional b c #rest d #!key e: f:)) 

1 2 3 4 5 6 e: 7 f: 8) 

The instantiation results in a=l, b=2, c=3, d=(4 5 6) e:=7 f:=8. 

3.2.5. Variables 

Variables are names that may be bound to values, in which case the variable evaluates 
to the value. Thus the value of a variable is the value of the associated expression. 

define 



(define variable-name expression) 



Binds the result of expression to variable-name 

Example 3-12. Variable Association 

(define x 3) 

X -> 3 

(define add3 (lambda (x) (+ x 3))) 

(add3 4) ^ 7 

(define (variable-name formal-argument-list) expression) 



A reduced syntax for defining procedures without using lambda expressions. 

Example 3-13. Reduced Procedure Definition 

(define (add3 x) (+ x 3)) 

(add3 4) -> 7 

Whenever an expression makes use of a variable, the variable must previously have 
been assigned some expression. It is an error to refer to an unbound variable. 

3.2.6. DSSSL Style Guide 

The expressions shown up to this point are quite simple. The ones to appear in the 
following sections of the book will increase in complexity, and the number of opening 
and closing parentheses will increase in number. With this in mind, it is appropriate to 
establish some guidelines for writing DSSSL expressions that will help to make their 
meaning clear and to reduce the possibility of errors. 

• Each expression that is considered simple or trivial will be written as a single line. If 
there is insufficient space, it will be treated as if it were a complex expression. 

• Each complex expression composed of simpler expressions will be written on several 
lines. 
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• Indentation will be used to visually distinguish the context of the line. Nested (or 
subordinate) expressions will be indented relative to their enclosing expressions. The 
two most common indentation strategies are to either indent a nested expression by 
two spaces relative to its enclosing expression, or to align a nested expression with 
the second nested expression that occurs in the same line as the enclosing expression. 
Expressions at the same level will be indented by the same amount. 

• Closing parenthesis will be placed together. As many programming editors auto- 
matically balance opening and closing parenthesis, it is easy to ensure their correct 
placement. There is no need, then, to visually distinguish which parenthesis closes 
which. 

Example 3-14. Writing of Expressions 

; Using the first indentation strategy 
(define (add3 x) 

(+ 3 X)) 

(lambda (x) 

(+ X D) 

( (lambda (x y) 

(+ X y) ) 

7 8) 

; Using the second indentation strategy 
(define (add3 x) 

(+ 3 X)) 

(lambda (x) 

(+ X D) 

( (lambda (x y) 

{+ X y) ) 

7 8) 

These rules shouldn’t be followed dogmatically. Their only intention is to facilitate the 
comprehension of expressions. The programmer can always apply the rule he consid- 
ers useful to help the understanding of the code. Many programming oriented editors 
support the contextual indentation of expressions with a set of standard rules that en- 
hance readability, so the programmer can rely on these rules, and not be distracted by 
parentheses, directing his efforts towards code generation. More than counting opening 
and closing parenthesis (something that editors do automatically), it is more important 
to indent expressions so that the indentation represents the nesting of expressions. 

3.2.7. Quotation of Expressions 

The existence of variables complicates somewhat the evaluation of expressions. As 
has already been stated, evaluation is strict and arguments are evaluated before the 
application is performed. 

To study the internal working of the expression language, let’s suppose a procedure 
is defined that is to be used to write letters, calling it write as in (define (write 
character) . . . ) . This procedure will be applied to letter x as in (write x) . 

First, the parameters are evaluated, wri te evaluates to a procedure. The problem arises 
with X. Of the five types of expressions that exist, x can only be a reference to an 
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unbound variable, which is an error as explained above (see Section 3.2.5). This occurs 
because x shouldn’t be evaluated as an expression, but as a constant character value. 
If nothing more is said, x will always be evaluated, instead of being interpreted as a 
literal, which in fact it is. The expression written this way will always return an error 
due to a reference to an unbound variable. To force the interpretation of x as a literal, 
it must be done explicitly. 

quote 



(quote expression) 



Prevents the evaluation of expression, causing it to be interpreted as if it were 
a literal. 

' expression 



This is an abbreviated representation of quote. 

Example 3-15. Quote 

(write (quote x) ) 

(write 'x) 

The two lines of code above are equivalent, and both treat x as a literal, without 
evaluating it. 



3.2.8. Conditional 

The last kind of expression allows the choice between two execution alternatives de- 
pending on the result of evaluating a test expression. 

if 



(if test consequent alternate) 

The boolean expression test is evaluated. If the result is #t, consequent is 
then evaluated, otherwise alternate is evaluated. 

Example 3-16. If 

A procedure is defined that will behave differently depending on whether the first 
argument is greater or lesser than a second argument. 

(define ( lesser-or-greater value compare) 

(if (> value compare) 

(greater value) 

( lesser value) ) ) 

Some other derived expressions are also very useful. 
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cond 



(cond ( (> 3 2) 'greater) 
( (< 3 2) 'lesser) 
(else 'equal)) 

— >■ greater 



case 



(case (+ 2 3) 

((2357) 'prime) 

((1 4 6 8 9) 'compound) 
(else 'nothing)) 
compound 



3.2.9. Scopes 

In the introduction, the language was said to be statically scoped with block structure. 
This means that a variable is bound to a value only in the scope where the definition is 
valid. A scope is: 

• the region delimited by the parentheses that surround the point where the definition 
is. 

• the whole program otherwise. 

In a procedure there can be definitions prior to the body specified by define: 

Example 3-17. Local Definition 

(define (a x) 

(define (by) . . . ) 
body) ) 

In this case procedure b only exists within the body of procedure a, where it can be 
called. 

There are also internal definitions, that are used to define variables that reduce the 
number of expressions and calls of the body. These internal definitions are specified 
with three primitives. 

let 



(let ((variable init) ...) body) 

Binds variable to init. Computes all init values before the variables are 
bound. The locally bound variables can be used in body. 
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Example 3-18. Let 

(define (proc x) 

(if (> X 0) 

(+ X 3) 

(/ (+ X 3) 2))) 

This procedure can be rewritten to simplify its body. 

(define (proc x) 

(let ((y (+x3))) ; variable y is defined with value x + 3 
(if (> X 0) 

Y 

(/ y 2)))) 

In this example, the benefits are doubtful, but if only the if portion is judged, it is 
true that the calculus (or body) of the procedure, has indeed been simplified. 

let* 



(let* ((variable init) ...) body) 

Binds variable to init. The variables are bound sequentially, which allows 
the use of a previously defined variable in the expression of subsequent variables. 
The locally bound variables can be used in body. 

letrec 



(letrec ((variable init) ...) body) 

Binds variable to ini t. All variables are considered to be bound while their 
values are being calculated, which allows mutually recursive definitions. The lo- 
cally bound variables can be used in body. 

There is a special case, called named-let that will be explained in the section about 
recursion and iterative processing. Section 3.4. 

3.2.10. And, Or 

These primitives, corresponding to the boolean connectors, allow more complex tests 
than the ones shown up to now. 

and 



(and test . . . ) 

Returns #t when all tests return # t. The first time a test returns #f the evaluation 
is cut and # f is returned. Tests are evaluated from left to right. 

Example 3-19. And 



(if (and (> x 1) (> x 10)) 
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or 



(or test . . . ) 

Returns # f when all tests return # f . The first time a test returns # t the evaluation 
is cut and #t is returned. Tests are evaluated from left to right. 

Example 3-20. Or 

(if (or (> X 1) (> X 10) ) ) 

The two boolean connector primitives are special constructs. They are implemented 
following what is called the evaluation cut. When the final value of a logical expression 
is known, it makes no sense to continue calculating the rest of terms. In an or primitive, 
when one of the arguments returns # t the result of the whole expression will be ^t. In 
an and primitive, when one argument returns # f the result of the whole expression will 
be In both primitives values are obtained sequentially and evaluation is cut when 
such values are found that make the final result known. 



3.2.1 1 . Quasiquote 

There is another set of primitives, related to quote whose explanation will be given 
in the section about lists (see Section 3.3.2. 1). They allow the evaluation of part of a 
quoted expression. 

3.3. Data Types 

The five types of expressions have already been explained together with some derived 
expressions and primitive procedures. This forms the heart of the programming lan- 
guage, but it is not enough. There are also data types. When an expression is evaluated 
it must return a value of some supported data type. In the introduction it was explained 
that types are related to values. We have seen how in the definition of a variable its 
name and bound expression are specified. A variable is only a name, and its type will 
be the type of the associated expression. Types are necessary to make sure that expres- 
sions are coherent. This differs from the common practice of imperative programming 
languages, like C, where variables have an associated data type. 



3.3.1. Booleans 

Booleans are values that follow the boolean algebra. In this algebra there only exist two 
values: true (represented in DSSSL by #t) and false (represented in DSSSL by #f). 
The only false value is #f ; any other value is interpreted as true, #t included. #t and 
#f are literals. 
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3.3.2. Pairs and Lists 

A pair is a structure composed of two fields: the car and the cdr. Sometimes they receive 
the name of dotted pairs due to the fact that their syntactic representation is by means 
of an intermediate point. 

Example 3-21. Pair 

(a . b) 

car=a 

cdr=b 

Pairs are mainly used to represent lists. The minimal list is the empty list (). Non trivial 
lists are pairs whose cdr is a list. For lists there is an abbreviated representation without 
the points of the pairs. 

Example 3-22. Proper List Representation 

(1 2 3 4 5) 

is equivalent to 

(1 . (2 . (3 . (4 . (5 . (>))))) 

A chain of pairs that doesn’t finish with the empty list is called an improper list. An 
improper list can be represented by mixing the dotted and list representations. 

Example 3-23. Improper List Representation 

(1 . (2.3)) is equivalent to (1 2 . 3) 

3.3.2.1 . Lists and Quote 

The list syntax is exactly the same as that of procedure application: there is no syntactic 
difference between them. Whenever a list is used as an argument to a procedure call, if 
nothing is done to prevent it, when the list argument is evaluated, it is assumed to be a 
procedure call to be executed. Thus, to ensure the correct interpretation, quote must be 
used. 

Example 3-24. Syntactic Similarity between Lists and Procedures 

There is no syntactic difference between the two lines of code below. 

(+ 3 4) 

(a b c) 

Both are lists and could also be interpreted as a procedure calls with two arguments. If 
a distinction is needed between both, quote must be used. 

(+ 3 4) 

' (a b c) 

Now, the first line is a procedure application that will be evaluated to 7, and the second 
line will be evaluated to a list. 

Sometimes, however, it is necessary to evaluate parts of a quoted list. 




24 



Chapter 3. The Programming Language 



quasiquote 



(quasiquote expression) 
' expression 



expression will be interpreted as a literal, in the same way as quote, but some 
parts of it can be evaluated if so specified. 

Example 3-25. Quasiquote 

(quasiquote (a b c) ) is equivalent to ' (a b c) 

Quasiquote is useful to construct a list structure when not all of its contents is 
known in advance. It is also called backquote because it is abbreviated by a back- 
quote (‘). 

Inside a quasiquote expression, the evaluation of parts of the expression can be forced. 

unquote 



(unquote expression) 

, expression 

expression will be evaluated, even if it occurs inside a quasiquote. It is ab- 
breviated by ,. 

Example 3-26. Unquote 

(quasiquote (list (unquote (+12)) 4)) 

-+ (list 3 4) 

' (list ,(+12) 4) 

^ (list 3 4) 

The two lines above are equivalent. 

unquote-splicing 

(unquote-splicing expression) 

, ©expression 

expression will be evaluated. The result of the evaluation shall be a list, whose 
opening and closing parenthesis will be stripped away. It is abbreviated by ,@. 

Example 3-27. Unquote-splicing 

(quasiquote (1 3 (unquote-splicing (cdr (quote (54 5 6)))))) 

->(1 3 5 6) 

' (1 3 ,©(cdr ' (54 5 6) ) ) 

-^(1 3 5 6) 

The two lines above are equivalent. 
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3.3.3. Symbols 

Symbols are objects whose usefulness rests on the fact that two symbols are identi- 
cal when they are written the same way. Symbols may be used, for instance, the way 
enumerated values are used in Pascal. 

3.3.4. Keywords 

Keywords are similar to symbols. The main difference is that they are self evaluating, 
and thus don’t need the use of quote in expressions. They are used to specify arguments 
to procedures. A keyword is an identifier followed by Keywords are atomic elements, 
and thus no space is allowed between the identifier and the The : is not considered 
part of the name of the keyword. 

3.3.5. Quantities 

Quantities represent lengths and quantities derived from lengths such as areas and vol- 
umes. Meter is the basic unit. 

Quantity is an abstract concept, and from it all the necessary numeric types are defined. 
The number data type is a subtype of quantity that represents dimensionless quantities. 
A subtype of number is real, representing real numbers, inexact by definition. Integer 
numbers, exact by definition, are a subtype of real. There also exists the angle data type, 
also dimensionless, used to represent angles and which is also a subtype of quantity. 

Figure 3-1. Subclasses of quantity 




real 



integer 

The language provides procedures that permit the conversion between exact and inexact 
quantities. 



3.3.6. Characters 

Characters represent letters and typographical signs. In short, anything that can be writ- 
ten is a character. 
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3.3.7. Strings 

Strings are sequences of characters. Their syntactic representation is a sequence of 
characters between surrounded by doublequotes ("). 



3.3.8. Procedures 

Procedures are the result of the evaluation of lambda expressions. 

3.4. Repetitive Processing 

The interest of computer processing comes from the ability to process large volumes of 
data. Those volumes of data must be accessible and structured. The abstract concept of 
sequence offers a model to manage the data. A sequence is a finite row of elements, all 
of the same kind. A header is used to traverse the sequence by accessing one element 
each time. This abstract concept has many implementations. A procedure can generate 
the sequence internally by means of a mathematical calculation. Another option is to 
have the data stored in some object model that behaves like a sequence. 



3.4.1. Lists 

The list data type is the only one capable of storing large volumes of data. The be- 
haviour of a list follows that of a sequence. Whenever in DSSSL a sequence is stored 
in some data model, it will be a list. Usually, in a repetitive process some list will be 
involved, be it as input, output or internal support of the process. 

3.4.2. Recursion 

DSSSL is a functional language. Anyone with a procedural programming background 
will have noticed the lack of iterative constructs such as while in C. In DSSSL repetitive 
processing is implemented by means of recursion. A recursive procedure is simply one 
that calls itself in its body. 

Example 3-28. Recursive Procedure 

(define (factorial x) 

(if (= X 0) 

1 

(* X (factorial (- x 1))))) 

Factorial procedure is defined in terms of itself. 

In every recursive procedure two parts can be distinguished, controlled by a conditional: 

• Trivial case: this is the case for which the result is known without the need of any 
calculation. It is the branch that closes the recursion and prevents an infinite recur- 
sion. In the previous example the trivial branch occurs when the value is zero, in 
which case by the mathematical definition of factorial the result is one. 
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• Recursive case: in this branch a definition of the result is given in terms of the same 
procedure under definition, but in a way that ensures an approach to the trivial case. 
In the example, for any non-zero value, each step of the recursion decrements the 
value by one; sooner or later the value will reach zero and the recursion will finish. 
In case someone wanted to obtain the factorial of a negative value, the procedure 
would enter an infinite recursion. It is not inherently wrong, as there is no mathemat- 
ical definition of factorial for negative values, and thus it is a mathematical error to 
calculate it. The infinite recursion could be prevented with a conditional testing that 
the value is zero or positive. 

The example below shows a possible execution of the factorial procedure. 

Example 3-29. Sequence of Recursive Evaluations 

(factorial 3) 

( * 3 ( factorial 2 ) ) 

(* 3 {* 2 (factorial 1) ) ) 

(* 3 (* 2 (* 1 (factorial 0)))) ; trivial case reached 
(* 3 (* 2 (* 1 1))) 

(* 3 (* 2 D) 

(* 3 2) 

6 

It has been explained that a sequence is the abstract model supporting repetitive cal- 
culations. In the case of the example above, the sequence is constructed by a series of 
calculations over time. Each step of the sequence is larger than the previous one until 
the trivial case is reached. After this point, steps keep reducing the size until the result 
is obtained. Thus, the execution increases in size relative to the value. The larger the 
value to calculate, the larger the size to execute will be needed. It is a usual criticism 
of functional languages that they are inefficient, due to their need of large space for 
execution. But DSSSL chooses a special kind of recursion with better performance. 



3.4.3. Tail Recursion 

DSSSL requires that implementations must be properly tail recursive. It means that the 
last application to be evaluated in the body of the procedure is the recursive call. This 
is not the case of the recursive procedures defined in the previous section. 

Let’s study Example 3-29 in detail. Each recursive step adds one multiplication and one 
recursive call. As the language uses strict evaluation, to solve the multiplication, first 
the two arguments must be evaluated. One of the arguments is the recursive call, with 
adds another multiplication level, and so on until the trivial case is reached. When the 
trivial case is reached, the results are carried back, and multiplications are solved from 
last to first, in an inverse order. It happens because the last procedure to execute is the 
multiplication. It is not a tail recursive procedure. 

The same procedure can be defined using a tail recursion model. The idea is to have 
the recursive call as the last call. To do it the procedure must be redefined. There is a 
common technique to convert recursive procedures into tail recursive procedures. To be 
able to apply this technique the procedure to be converted has to have a single recursive 
call. 
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The technique to convert single recursive call procedures into tail recursive procedures 
is called immersion. A second procedure is defined, the immersed procedure, adding 
an argument, the accumulator, that stores the partial results. In the accumulator the 
operations other than the recursive one are performed. 

Example 3-30. Immersed Function 

(define (factorial x) 

( immersed_f actorial x 1 ) ) ; accumulator receives value of trivial case 

(define ( iiranersed_f actorial x accum) 

(if (= X 0) 
accum 

( immersed_f actorial 

(- X 1) 

( * accum x) ) ) ) 

immersed-f actorial is already a tail recursive procedure, and factorial procedure is just 
a previous step for the immersed procedure. The difference with the previous definition 
will be more clear looking at the new sequence of evaluations. 

Example 3-31. Sequence of Tail Recursive Evaluations 

(factorial 3) 

( immersed_f actorial 3 1) 

(immersed_f actorial 2 (* 1 3)) 

(immersed_f actorial 2 3) 

( immersed_f actorial 1 (* 3 2)) 

(immersed_f actorial 1 6) 

( immersed_f actorial 0 (* 6 1)) 

(immersed_f actorial 0 6) 

6 

In this sequence, the last call is no more the multiplication, but the immersed_factorial 
procedure. The partial multiplication is calculated internally in the accumulator each 
step. 

We hope this example is enough to understand the concept of tail recursion. The expla- 
nation given above is the basic idea of tail recursion. It seems that Scheme and DSSSL 
consider a wider case of tail recursion, but it doesn’t seem to be a closed discussion, 
as seen in the discussion groups. There are some books that explain the concept with 
more detail and completeness. See [tailrec]. Tail recursive procedures execute in con- 
stant space. It can be verified in the two execution examples above that the tail recursive 
procedure executes in the same space in each step. Tail recursive procedures have an- 
other benefit: there is no need to keep track of previous calculations between steps, 
because the accumulator stores the history of the executions. This is the reason for the 
constant space execution. It has been mathematically demonstrated that tail recursive 
procedures execute in constant space. A tail recursive procedure is equivalent, in all 
respects, to the iterative constructs of imperative programming languages. 
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3.4.4. Named Let 

There is one last language primitive designed to support repetitive processing. The 
named let has the same syntax and semantics as ordinary let. As with ordinary let, it 
is used to create scopes, but in the case of the named let, the let has a name, and it 
works as if it were a procedure name, whose parameters are the variables defined in the 
named let. Thus, inside the named let, the body of the named let can be invoked in a 
tail recursive way by means of its name. 

Example 3-32. Named-let 

(define (factorial x) 

(let loop ((value x) 

(accum 1) ) 

(if (= value 0) 
accum 
(loop 

(- value 1) 

( * accum x) ) ) ) ) 

In this procedure, loop is the name of the let, value and accum are names of vari- 
ables defined inside the let scope, but they also behave as parameters of the loop proce- 
dure. Each time loop procedure is called inside the let body, it is equivalent to a jump 
to the start of the body of the let assigning to the variables the values of the arguments 
of the call. 

Named let keeps syntactic similarities with the iterative constructs of imperative lan- 
guages, but it is still a tail recursive model. 

3.4.5. Map and Reduce 

There are two inherently functional constructs, used to implement repetitive processing, 
which are especially useful for list processing. 

map 



(map proc list^ 

Procedure map applies proc to all the elements of one or more lists, taking one 
element of each list as parameter each time, proc should accept as many argu- 
ments as there are lists. 

Example 3-33. Map 

(map 

(lambda (x) (+ x 1) ) 

'( 12345 )) 

-^(2 3 4 5 6) 

(map + '(1 2 3) '(4 5 6)) 

-^(5 7 9) 

See Also: map in Section 3.5. 
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reduce 



(reduce list combine init) 



This procedure is not proper part of the programming language defined in DSSSL, 
although its definition is offered in order to implement some other procedures. 
Due to the usefulness of the procedure, the author takes the liberty of including its 
explanation into the book. 

The procedure reduce takes three parameters. The second parameter, combine, 
must be a procedure that takes two arguments. The procedure will be applied to 
the car of list and the accumulated result, then reducing the cdr of list. The 
name of the procedure explains the effect it causes on lists, reducing them to a 
single value. 

Example 3-34. Reduce 



(reduce 

' (7 1 5 10 4) list 

(lambda (x y) (if (> x y) x y) ) .combine 
0) Initial value 

— > (reduce '(1 5 10 4) (lambda ...) 7) 

(reduce '(5 10 4) (...) 7) 

(reduce '(10 4) (...) 7) 

^ (reduce '(4) (...) 10) 

— > (reduce '() (...) 10) 

10 

As an example of the usefulness of the procedures above, the following examples shows 
how a list might be sorted. 

Example 3-35. Sort an Integer List by Direct Insertion 

(define (insert x ordered-list ) 

(let loop ((1 ordered-list) 

(11 ' ( 1 ) ) 

(if (or (null? 1) (< x (car 1))) ; or cuts the evaluation with ttt 

(append 11 (list x) 1) 

(loop (cdr 1) 

(append 11 (list (car 1)))))))) 



(define (sort 1) 

(if (empty-list? 1) 

0 

(reduce 
(cdr 1) 
insert 

(car 1 ) ) ) ) ; atomic lists are always sorted 

The standard only provides the map procedure for list processing, although it offers the 
definition of reduce on page 132 when node-list-union procedure is defined. The query 
language (see Chapter 5) makes use of both constructs. 
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3.5. Standard Procedures 

These are the procedures predefined in DSSSL. They cover a broad range of generic 
applications, intended mainly for the manipulation of the basic data types. 



3.5.1. Booleans 

boolean? 



(boolean? obj ) 

Returns # t when ohj is boolean. 

Example 3-36. Boolean? 

(boolean? #t) #t 

not 

(not obj) 

Returns the opposite boolean value to obj. 

Example 3-37. Not 

(not #t) #f 

3.5.2. Equivalence 

equal? 



(equal? obj^ 

Returns #t if obj^ and obj should be regarded as the same object. It estab- 
lishes an equivalence relation between objects. For the basic data types (boolean, 
symbol, char, pair, quantity, string) the behaviour is the commonly expected. For 
procedures equality is not well defined. 



3.5.3. Pairs and Lists 

pair? 



(pair? obj) 

Returns # t when obj is a pair. 
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Example 3-38. Pair? 

(pair? ' (x y z) ) — ^ #t 

cons 



(cons obj^ 



Returns a pair whose car is obj^ and whose cdr is ohj^. 

Example 3-39. Cons 

(cons '1 ' 0 ) -> (1) 



car 



(car pair) 



Returns the car of pair. 

Example 3-40. Car 

(car ' {a . b) ) — ^ a 
(car ' (a b) ) ^ a 
(car ' ( ) ) error 



cdr 



(cdr pair) 



Returns the cdr of pair. 

Example 3-41. Cdr 

(cdr ' (a . b) ) — ^ b 
(cdr ' ( ) ) ^ error 



c...r 



(c . . . r pair) 

Under this heading is a set of procedures that combine the car and the cdr in 
various ways. These procedures are: caar, cadr, cdar, cddr, caaar, caadr, cadar, 
caddr, cdaar, cdadr, cddar, cdddr, caaaar, caaadr, caadar, caaddr, cadaar, cadadr, 
caddar, cadddr, cdaaar, cdaadr, cdadar, cdaddr, cddaar, cddadr, cdddar, cddddr. To 
understand the definitions, for example, the cadr procedure would be equivalent 
to (define cadr (lambda (x) (car (cdr x) ) ) ) . 

Example 3-42. c...r 



(cadr ' (a b c) ) 



b 
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null? 

(null? ob j ) 

Returns # t when obj is the empty list. 

Example 3-43. Null? 

(null? ' 0 ) -> #t 

list? 

(list? obj) 

Returns #t when obj is a list (that is, a pair terminated by the empty list). 

Example 3-44. List? 

(list? ' (x y) ) #t 

list 

(list obj . . . ) 

Returns a list composed of the procedure’s arguments. 

Example 3-45. List 

(list 'a 'b ' (c d) ) — (a b (c d) ) 

(list) — >■ 0 

length 

(length list) 

Returns the number of elements in list. 

Example 3-46. Length 

(length '(abed)) -^4 

append 

(append list . . . ) 

Returns a list concatenating all the argument lists. 

Example 3-47. Append 



(append '(ab) '(cd) '(ef)) 



(a b c d e f) 
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reverse 

(reverse list) 

Returns a list with the elements in the inverse order of list. 

Example 3-48. Reverse 

(reverse ' (x y z) ) — > (z y x) 

list-tail 

(list-tail list k) 

Returns the tail of list discarding the first k elements. 

Example 3-49. List-tail 

(list-tail '(abed) 2) — >• (c d) 

list-ref 

(list-ref list k) 

Returns the Jc-th element of list. The index of the first element is zero. 

Example 3-50. List-ref 

(list-ref ' (a b c) 1) b 

member 

(member obj list) 

Returns the largest tail of list whose car is obj. It can be used to test whether 
obj is a member of list (as if it were a set). When obj is not a member, returns 
the empty list. 

Example 3-51. Member 

(member 'y ' (x y z) ) — > (y z) 

assoc 

(assoc obj list) 

Returns the pair associated with the key obj in the association list list. Asso- 
ciation lists are composed by lists of two elements. The first element of the pair is 
interpreted as a key, and the second as a value. If there is no pair associated with 
the key obj, #f is returned. 
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Example 3-52. Assoc 

(assoc 'y ' ( (x 1) (y 2) (z 3))) (y 2) 

3.5.4. Symbols 

symbol? 

(symbol? ob j ) 

Returns # t when obj is a symbol. 

Example 3-53. Symbol? 

(symbol? 'x) #t 

symbol->string 

(symbol->string symbol) 

Converts symbol into a string. 

Example 3-54. Symbol->string 

(symbol->string 'abc) — > "abc" 

string->symbol 

(string->symbol string) 

Converts string into a symbol. 

Example 3-55. String->symbol 

(string->symbol "abc") — > abc 



3.5.5. Keywords 

keyword? 

(keyword? obj) 

Returns # t when obj is a keyword. 

Example 3-56. Keyword? 

(keyword? a:) — ^ #t 
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keyword->string 

(keyword->string keyword) 

Converts keyword into a string. 

Example 3-57. Keyword->string 

(keyword->string a:) — > "a" 

string->keyword 

(string->keyword string) 

Converts string into a keyword. 

Example 3-58. String->keyword 

(string->keyword "a") ^ a: 



3.5.6. Quantities and Numbers 

define-unit 



(define-unit name expression) 



In DSSSL, to represent quantities, the international measure system is used, with 
m (the SI meter) as the unit of measure. Any quantity can be represented as a prod- 
uct of a number and the unit of reference raised to an integer. The dimension of a 
quantity is the exponent to which the unit of measure is raised. For convenience, 
DSSSL allows the definition of derived units. Concretely, DSSSL offers a set of 
predefined units. 



(define-unit cm 0.01m) 

(define-unit mm 0.001m) 

(define-unit in 0.0254m) 

(define-unit pt 0.0003527778m) 

(define-unit pica 0.004233333m) 

In addition the standard uses the angle numeric data type (considered to be dimen- 
sionless) and recommends its definition as (define-unit rad 1 ) . 

quantity? 



(quantity? ob j ) 

Returns #t when obj is a quantity. 




Chapter 3. The Programming Language 



37 



number? 

(number? ob j ) 

Returns #t when obj is a number. 

real? 

(real? obj) 

Returns #t when obj is a real. 

integer? 

(integer? obj) 

Returns # t when obj is an integer. 



(= q, q, . . .) 

Returns #t when the arguments are equal. When the quantities are inexact (see 
Section 3.5.6. 1) the result may be unreliable. The dimension of the arguments 
must be identical. 



« q, q^ • ■ .) 

Returns # t when the arguments are monotonously increasing. The dimension of 
the arguments must be identical. 

(> q, q, ...) 

Returns # t when the arguments are monotonously decreasing. The dimension of 
the arguments must be identical. 

«= q, q, ...) 

Returns # t when the arguments are monotonously nondecreasing. The dimension 
of the arguments must be identical. 



(>= q, q, ...) 
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Returns # t when the arguments are monotonously nonincreasing. The dimension 
of the arguments must be identical. 

zero? 



(zero? q) 

Returns #t when g is zero. If the quantity is inexact the result can be unreliable. 
See Section 3.5.6. 1. 

positive? 

(positive? q) 

Returns #t when g is greater than zero. 

negative? 

(negative? q) 

Returns #t when g is less than zero. 

Odd? 

(odd? q) 

Returns #t when g is odd. 

even? 



(even? q) 

Returns # t when g is even. 



max 



(max % • • • ) 

Returns the maximum of the arguments. The dimension of the arguments must be 
equal, and the result will have the same dimension. 



(min q^ q^ . . . ) 

Returns the minimum of the arguments. The dimension of the arguments must be 
equal, and the result will have the same dimension. 



(+ q, . . .) 
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Returns the sum of the arguments. The dimension of the arguments must be equal, 
and the result will have the same dimension. 



(- q) 

Changes the sign of q. 

(- q, q, ...) 

Returns q^ less the sum of .... The dimension of the arguments must be 
equal, and the result will have the same dimension. 

Example 3-59. - 

(- 3 4 5 ) ^ -6 
(* q, . . .) 

Returns the product of the arguments. The dimension of the arguments must be 
equal, and the result will have the same dimension. 



(/ q) 

Returns 1 divided by g. 

(/ q, q, . . .) 

Returns the quotient of g^ by the product of g .... The dimension of the argu- 
ments must be equal, and the result will have the same dimension. 

Example 3-60. / 

(/ 4 5 6 ) 4/30 

abs 



(abs q) 



Returns the magnitude of g. 

quotient 



(quotient n^) 

Returns the quotient of the integer division. Always has the sign of the product of 
the arguments. 
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modulo 

(modulo n^) 

Returns the remainder of the integer division. Always has the sign of the divisor. 

remainder 

(remainder n^) 

Returns the rest of the integer division. It is zero or has the sign of the dividend. 

floor 

(floor x) 

Returns the largest integer not larger than x. 

ceiling 

(ceiling x) 

Returns the smallest integer not smaller than x. 

truncate 

(truncate x) 

Returns the integer closest to x whose absolute value is not larger that the absolute 
value of X. 

round 

(round x) 

Returns the integer closest to x, rounding to even when x is halfway between two 
integers. 

exp 



(exp x) 



Returns e raised to x. 

log 



(log x) 

Returns the natural logarithm (base e) of x. If x is zero or negative, an error will 
be generated. 




Chapter 3. The Programming Language 



41 



sin 



(sin x) 

Returns the sine of x. 



cos 



(cos x) 



Returns the cosine of x. 

tan 



(tan x) 

Returns the tangent of x. 

asin 



(asin x) 

Returns the arc sine of x. 

acos 



(acos x) 

Returns the arc cosine of x. 

atan 



(atan x) 



Returns the arc tangent of x. 

sqrt 



(sqrt q) 



Returns the square root of q. The dimension of g must be even. The dimension 
of the result will be half the dimension of q. If q is negative, an error will be 
generated. 



expt 



(expt x^ x^) 

Raises x to x . 
1 2 
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quantity->number 

( quant ity->number q) 

Returns the number of quantity g. 

number->string 

( number- >string number) 

Returns a string with a representation of number in base 10. 

{number->string number radix) 

Returns a string with a representation of number in base radix, radix must 
be one of 2, 8, 10 or 16. 

string->number 



(string->number string) 



Returns a number of the maximally precise representation expressed by string 
in base 10. 

(string->number string radix) 

Returns a number of the maximally precise representation expressed by string 
in base radix, radix must be one of 2, 8, 10 or 16. 

format-number 

( format -number n string) 

Returns a string representation of n. string specifies the format to use: 



• " 1 " means to use 0,1,2 

• "01" means to use 01, 02, 03, ... 10, 11, ... 100, 101, and similarly for any 
number of leading zeros 

• "a" means to use 0, a, b, c, ... z, aa, ab, ... 

• "A" means to use 0, A, B, C, ... Z, AA, AB, .... 

• "i" means to use 0, i, ii, iii, iv, ... 

. "I" means to use 0, 1, II, III, IV, V, ... 

Example 3-61. Format-number 

( format -number 4 "a") ^ "d" 
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format-number-list 

(format-number-list list format string) 

Returns a string representation of the integer list, format specifies the format, 
as in format-number, string specifies the separator to use between each integer. 

( format -number- list list format ' (string . . .) ) 

Returns a string representation of the integer list, format specifies the format, 
as in format-number. ( s tring ... J is a list with one string less than the length 
of list and specifies the separator to use between each pair of integers. 

Example 3-62. Format-number-list 

( format -number- list '(12 3) "a" " ") — > "a b c" 

( format -number- list '(1 2 3) "a" ("," ".")) — >■ "a,b.c" 

3.5.6.1. Exactness in Quantities 

The language distinguishes between exact and inexact quantities. For example, an in- 
dex to access a data structure must be known exactly. Each quantity is exact or inexact. 
Inexactness is a contagious property of quantities: when for the computation of a quan- 
tity an inexact operation is used, the quantity will be inexact. A quantity is exact when 
it is an exact quantity or when it was derived from exact quantities by means of exact 
operations. 

exact? 



(exact? q) 

Returns #t when q is an exact quantity. 

inexact? 



(inexact? q) 

Returns #t when g is an inexact quantity. 

exact->inexact 



(exact->inexact q) 

Returns an inexact representation of q. 

inexact->exact 

( inexact->exact q) 



Returns an exact representation of g. 
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3.5.7. Characters 

Characters are represented by #\character or #\character-name. Character-name must 
be the name of a character declared in the char -repertoire element type form 
(see Section 2.4). 

Example 3-63. Characters 

#\A 

#\space 



char? 



(char? ob j ) 

Returns #t when obj is a character. 

char=?, char<?, char>?, char<=?, char>=? 

(char=? char^ char^) 

These procedures impose a total ordering on the set of characters. All of these the 
procedures except char= ? use the current language. 

char-ci=?, char-ci<?, char-ci>?, char-ci<=?, char-cl>=? 



(char-ci = ? char^ char^) 

These procedures impose a total ordering on the set of characters. These proce- 
dures are similar to char= ?, but they treat upper-case and lower-case as the same. 
All of these procedures use the current language. 

Example 3-64. Char-ci=? 

(char-ci = ? #\A #\a) — > #t 

char-upcase 



(char-upcase char) 



Returns the upper-case equivalent of char as defined by the current language. 
See Section 3.5.7.2. 

char-downcase 



(char-downcase char) 



Returns the lower-case equivalent of char as defined by the current language. 
See Section 3. 5. 7. 2. 
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char-property 

(char-property symbol char) 

Returns the value of property symbol of char, otherwise returns the default 
value of property symbol. 

(char-property symbol char ob j ) 

Returns the value of property symbol of char, otherwise returns obj. 

See Section 3.5.7. 1. 

3.5.7.1 . Character Properties 

Each character has a set of named properties, each of which has a default value. 

Table 3-1. Pre-defined character properties 



Property 


Type 


Default 


Description 


numeric-equiv 


integer 


#f 


Numeric equivalent of the character. 



The style language pre-defines additional character properties that are used to deter- 
mine the default value of certain non-inherited characteristics of character flow objects. 
Character properties are accessible with the char-property procedure. 

Table 3-2. Character properties pre-defined by style language 



Property 


Type 


Default 


Description 


space? 


boolean 


#f 


Is the character a space? 


record-end? 


boolean 


#f 


Is the character a record-end? Both record-end? 
and space? are #t for record-end characters. 


blank? 


boolean 


#f 


Has the character any glyph associated? 


input-tab? 


boolean 


#f 


Is the character a tab on input? 


input- 

whitespace? 


boolean 


#f 


Is the character a whitespace on input? 


punct? 


boolean 


#f 


Is the character a punctuation character for the 
purpose of hanging punctuation? 
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Table 3-2 (cont.). Character properties pre-deflned by style language 



Property 


Type 


Default 


Description 


script 


String 


#f 


Scripts are codified with the prefix "ISO/IEC 
10179: 1996//Script::" followed by one of the 
strings Latin, Greek, Cyrillic, Arabic, Hebrew, 
Armenian, Georgian, Devenagari, Gujarati, 
Gurmukhi, Bengali, Oriya, Telugu, Tamil, 
Kannada, Malayalam, Thai, Lao, Han, 

Bopomofo, Hiragana, Katakana, Hangul, 
Burmese, Khmer, Mongolian, Ethiopian, Sinhala, 
Tibetan, Punctuation, Symbol, Digit. 


glyph-id 


glyph-id 


#f 


Glyph to be used for this character. 


drop- after-line- 
break? 


boolean 


#f 


Is the character dropped if immediately after a 
line break? 


drop-unless- 

before-line- 

break? 


boolean 


#f 


Is this character discarded unless before a line 
break? 


break-before- 

priority 


integer 


0 


Affects whether a break is allowed before this 
character; see break-before-priority: in Section 
7.3.10. 


break-after- 

priority 


integer 


0 


Affects whether a break is allowed after this 
character; see break-before-priority: in Section 
7.3.10. 


math-class 


symbol 


ordinary 


ordinary, operator, binary, relation, opening, 
closing, punctuation, inner 


math-font- 

posture 


symbol 


1 


accepts values #f, not-applicable, upright, 
oblique, back- slanted-oblique, italic, 
back- slanted, italic, math 



Additional properties can be added with add-char-properties. 



declare-char-property 



(declare-char-property property default) 

Declares a character property property with default value defaul t. 

add-char-properties 



(add-char-properties property: value . . . characters) 



Adds property with value to all the characters. Each property used by a 
specification must either be defined in the standard or by means of declare-char- 
property. 
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S.5.7.2. Language-Dependent Operations 

Certain operations on characters depend on the natural language being used. Examples 
of these operations are case conversions, character ligatures and hyphenations. 

define-language 



(def ine-language variable (collate ...) case-conversion) 

Binds variable to an object of type language. Objects of type language define the 
behaviour of languages. 

(collate 

(element identifier string) . . . 

(symbol identifier) . . . 

(order . . . ) ) 

collate determines the relative order of strings. Some languages use letters com- 
posed of more than one character, such as the letter CH in Spanish, which is com- 
posed of the characters C and H. When two strings are compared, each string is 
divided up into either a single character or a sequence of consecutive characters 
that is to be treated as a single unit. Each of them is a collation element. 

With the element procedure, identifier is declared as a collating element and 
it is associated with string. It is mainly a mechanism for languages that have 
letters composed of more than one character, identifier will then be used in 
the order procedure. 

Example 3-65. Collation Element 

In Spanish, there are two compound letters: ch, 11. They would be declared as 
below. 

(element 'Ll "LI") 

(element '11 "11") 

(element 'Ch "Ch") 

(element 'ch "ch") 

The symbol procedure declares identifier as a weight identifier to be used in 
order specifications. 

(order ( forward | backward | posit ion) characters) 

The order procedure defines a number of different comparison levels. If two 
strings compare equal at the first level, the comparison is repeated for subsequent 
levels until there are no more levels or the strings compare unequal. At a given 
level, each element in the strings to be compared is assigned zero or more 
weights. This results is an ordered list of weights for each string, backward and 
forward determine the comparison direction for the level, backward proceeds 
from the last weight to the first, position keyword specifies that the position of 
the element corresponding to the weight shall be considered. When comparing 
two weights with different positions, the weight with the earlier position in the 
comparison direction shall collate first. 
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(toupper (character^ character^) ...) 

Declares the upper-case equivalent of character^ in each pair to be 

character . 

2 

(tolower (character^ character^) ...) 

Declares the lower-case equivalent of character^ in each pair to be 
character^. 

Example 3-66. Define-language 

(def ine-language en 
(collate 
(order 

( forward) 

#\space #\A \#a \#B ... ) ) 

(toupper (\#a \#A) (\#b \#B) ...) 

(tolower (\#A \#a) (\#B \#b) ...)) 

To expand on this language definition mechanism, a message by James Clark in 
the DSSSL distribution list is quoted below. 

“All the collation stuff in DSSSL is just ISO/IEC 9945-2 with a Scheme syntax. 
If you want to understand it, I would strongly recommend looking at 9945-2.” 

“One reason you need multiple level-sort-rules is for languages like French. Typ- 
ically you sort first ignoring accents and then use accents to sort words that com- 
pare the same when you ignore accents. The forward / backward business is also 
for French. If you have two strings that compare equal ignoring accents, then you 
search for the *last* character which differs when you don’t ignore accents.” 

“Actually even with English it’s useful to have multiple sorting levels. The sorting 
rules are designed to determine the ordering of any non-identical strings. One 
way to deal with non-alphabetic characters in a string is to sort first ignoring the 
non- alphabetical characters and then to use the non-alphabetic characters to order 
strings that have the same alphabetic characters. (This case is where the position 
keyword is for). Also it’s common to sort first ignoring case, and then to use case 
to order strings that compare identical case- insensitively.” 

language? 

(language? ob j ) 

Returns #t when obj is a language. 

declare-default-language 

( dec lare-default- language language) 

Declares that language will be the current language initially used in the evalu- 
ation of expressions. 
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current-language 



( current- language ) 



At any point in the processing some language could be in use. current-language 
returns the language in use, or # f if there is none. 

with-language 



(with-language language proc) 



proc, a procedure without parameters, is executed with language as the current 
language. 

3.5.8. Strings 

Strings are sequences of characters enclosed in doublequotes ("). The escape character 
in strings is the backslash (\). This allows inclusion of doublequotes in strings: "The 
character \" is a doublequote". Backslash can also be introduced in the same way into 
a string: "The character W is a backslash". The #\ notation (see Section 3.5.7) may be 
used to write any character inside a string. The character name must be followed by a 
semi-colon (;) unless the character is the last character of the string or the following 
character is not one of a..zA..Z0..9:!$%&*/<=>?~_^.+-. 

String? 



(string? ob j ) 



Returns # t when obj is a string. 

String 



(string char . . . ) 

Returns a string composed of the characters. 

String-length 

(string-length string) 

Returns the number of characters in string. 

String-ref 

(string-ref string k) 

Returns the k-th character of string (indexing starts at zero), k must be a valid 
index for string. 
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Strings? 



(string=? string^ string^) 

Returns #t when the two strings are equal. 

string-ci=? 



(string-ci=? string^ string^) 

Returns # t when the two strings are equal in a case insensitive way as defined by 
the current language. 

See Also: define-language. 

sthng<?, string>?, string-ci<?, string-ci>? 



(string<? string^ string^) 

Compare strings in a similar way to char= ? and char-ci= ?. 

string-equiv? 



(string-equiv? string^ string^ k) 

Returns # t when the two strings compare the same at the first k. comparison levels 
of the collation specification of the current language, k must be strictly positive. 
See Also: define-language. 

substring 



(substring string start end) 



Returns the characters of string between index start (included) and end 
(excluded). The first character of string has index zero. 

String-append 



(string-append string . . . ) 

Returns a string formed by the concatenation string . . .. 

string->list 



(string->list string) 



Returns a list of the characters forming string. 

iist->string 



(list->string chars) 

Returns a string formed by the characters in the list chars. 
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3.5.9. Procedures 

procedure? 



(procedure? obj ) 



Returns #t when obj is a procedure. 

apply 



(apply proc args) 



The essential form calls proc with the elements of args as the actual arguments. 

(apply proc arg^ . . . args) 

This is a generalization of the essential form that calls proc appending all the 
arguments into a list like in ( append (list arg^ ...) args). 

Example 3-67. Apply 

(apply + '(12)) ^3 
(apply +12) -^3 



map 



(map proc list^ list^ . . . ) 

This procedure applies proc taking as arguments one element of each list at a 
time. There must be as many lists as there are arguments in proc, and the lists 
should be of the same length. 

Example 3-68. Map 

(map +'(135) '(456)) 

^(58 11 ) 

See Also: Section 3.4.5. 

external-procedure 



(external -procedure string) 



Returns a procedure whose public id is string. The procedure should be side- 
effect free. It should be used to retrieve information from the system rather than 
to change the state of the system. 
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3.5.10. Date and Time 

time 



( t ime ) 

Returns the number of seconds since 1970-01-01 00:00:00 GMT as an integer. 

time->string 

( time->string k #! optional boolean) 

Converts an integer k into an ISO 8601 string representation of a date. If 
boolean is #t GMT representation is to be used. 

time<?, time>?, time<=?, tlme>=? 



{time<? string^ string^) 
(time>? string^ string^) 
(time<=? string^ string^) 
(time>=? string^ string^) 



These procedures impose a total ordering on the set of strings that represent dates 
and times in ISO 8601 format. 



3.5.11. Error Signaling 

error 



(error string) 



Signals an error in a system dependent way with string describing the error. 
No value is returned. 

3.6. Core Expression Language 

The core expression language defines a subset of the expression language which in- 
cludes only the forms listed below. This subset is the one used by default in the style 
language unless the expression feature is specified (see Section 2.3.2). 

• (not obj) 

• (boolean? obj) 

• (equal? obj ^obj^) 

• (null? obj) 
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• (list? obj) 

• (list obj...) 

• (length list) 

• (append list ...) 

• (reverse list) 

• (list-tail list k) 

• (list-ref list k) 

• (member obj list) 

• (symbol? obj) 

• (keyword? obj) 

• (quantity? obj) 

• (number? obj) 

• (real? obj) 

» (integer? obj) 

• (■=%%%■■■) 

■ (<qiq2q3-) 

• (>q,q2q3-) 

• «=qiq2q3-) 

• (>=q,q2q3-) 

• (maxqjq^qj...) 

• (min qj q^ qj ...) 

• (+q,...) 

• (*q,...) 

• (-q.q^) 

• (-q.) 

• (/qjqj) 

• (/q.) 

• (abs q) 

• (quotient n^ n^) 

• (remainder n^ n^) 

» (modulo Uj n^) 

► (floor x) 

• (ceiling x) 
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• (truncate x) 

• (round x) 

• (sqrtq) 

• (number->string number) 

• (number->string number radix) 

• (format-number n string) 

• (format-number-list list obj^ obj^) 

• (string->number string) 

• (string->number string radix) 

• (char? obj) 

• (char=? char^ char^) 

• (char-property symbol char) 

• (char-property symbol char object) 

• (string? obj) 

• (string char ...) 

• (string- length string) 

• (string-ref string k) 

• (string=? stringy stringy) 

• (substring string start end) 

• (string- append string ...) 

• (procedure? obj) 

• (apply proc args) 

• (external-procedure string) 

• (time) 

• (time->string k) 

• (time->string k boolean) 

• (error string) 
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4.1 . Introduction 

This process is the first step of processing using DSSSL. DSSSL defines a grove pro- 
cessor both at the start of the transformation process (see Chapter 6), and at the start 
of the style process (see Chapter 7). The grove processor is in charge of analyzing the 
SGML document and constructing a representation in the form of a graph as specified 
by the grove-plan. 

An SGML document is a text file, a format poorly suited for efficient processing due to 
its sequential nature. 

There are two different classes of text in an SGML document: on the one hand, there 
is the actual content of the document, and on the other there is the SGML markup, 
which is text that is added to the content of the document. The SGML markup itself is 
divided into a declaration that stipulates the aspect the the markup will take: a document 
type definition that gives grammatical rules that determine what markup is acceptable; 
and element tags, that are inserted within the content of the document, representing a 
preorder traversal of an instance of the tree allowed by the document type. There is also 
the ID/IDREF pair of attributes that define a partially directed graph structure between 
separate points of the document. Furthermore, the tags contain attributes and there are 
marked-sections and processing instructions. 

To efficiently process the quantity of structures that coexist within an SGML document, 
DSSSL offers a data model called a grove. The HyTime standard defines grove as an 
acronym of ’’Graphical Representation Of property ValuEs”. 
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Example 4-1. A Basic Grove 



As an example, the following document would produce the following grove: 
<book> 

<title>Course</title> 

<chapter> 

<title>A</title> 

<para>Bc/para> 

<para>C</para> 

<para>D</para> 

</chapter> 

</boolc> 




Course 



title 




para 




para 




para 


A 


B 


c 


1 

D 



This example is clearly a simplification as there are no attributes nor ID / IDREF unions 
nor many other things, but it gives an appropriate idea of the process. Below, we will 
study the process in detail as in this short example leaves out many important details. 

4.2. Property Sets 

The complete definition of what a property set is appears in the HyTime standard. The 
DSSSL standard presents a simplified version that includes only those details that are 
necessary. 

The basic idea is that any notation can be used to manipulate more basic information. 
SGML is a textual notation. MP3 is a binary notation. Given a notation, one needs what 
is called a notation processor which is a program capable of understanding the notation 
and presenting the information contained therein in an appropriate way. For example, 
an SGML processor would be a program capable of understanding the meaning of the 
declarations and of the DTD, of distinguishing the markup from the content and of 
presenting the content of the document in an appropriate manner by which it can be 
understood, giving it, for example, an appropriate format. 

Notations, such as for example SGML, exist only as syntax for a simpler model. Nota- 
tions make the information storable and transportable. But independent of the notation, 
the underlying information has its own structure. Property sets formally describe the 
structure of the information. 
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Property sets are defined according to the propset DTD which, in HyTime terms, is 
an Architectural Form. That is, property sets are defined using SGML documents. In a 
property set, the root element is propset. 

The two fundamental concepts of property sets are classes (classdef) and properties 
(propdef). A class is an ordered set of properties. A property has a data type (datadef) 
that specifies the set of values that it may accept (or exhibit). These components are 
grouped together in modules to facilitate their management. 

4.3. Intrinsic Data Types 

There is a set of data types, called intrinsic, that is defined for every property set. These 
types are either nodal or nonnodal. The values of nodal data types are nodes or lists of 
nodes, forming links between classes. A node is the representation of a class. 

Nonnodal Intrinsic Data Types 

• boolean: a boolean value (true/false) 

• char: a character 

• string: a list of characters 

• integer: an integral number 

• integer list: a list of integers 

• enum: an enumeration of values 

• component name: the name of a class, property or enumerated value 

• component name list: a list of component names 

Nodal Intrinsic Data Types 

• null: The definition of a property may allow that property to have a null value 
instead of the declared data type when some condition is not fulfilled. 

• node: a pointer to another class. Defines a relationship between two nodes. This 
relationship can be of three kinds: 

• subnode: the default relationship which indicates a relationship of inclusion. 

• irefnode: a relationship between two nodes in the same grove. 

• urefnode: a relationship of inclusion without restrictions, that is, it can relate nodes 
from different groves. 

• node list: a list of nodes 

• named node list: every named node list has an associated name based on some prop- 
erty of the node. This is how attributes are implemented. 

4.4. Intrinsic Properties 

There is a set of properties, called intrinsic, that is predefined for every propset. It is as 
though these properties are defined for every class of a property set. 
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• class-name: is the name of the node’s class. 

• grove-root: is a nodal property that points at the root of the grove 

• subnode-property-names: is the list of the names of all the subnode properties exhib- 
ited by the node. 

• all-property-names: is the list of the names of all the properties exhibited by the node. 

• children-property-name: if the class has children, indicates the name of the property 
that contains them. In fact it is the property that contains the data. Only one children 
property is permitted per class. 

• data-property-name: when a class contains textual data, indicates the name of the 
property that contains the data. 

• data-sep-property-name: is the name of the property that specifies the data separator 
if any. 

• parent: property that points to the parent if any. 

• tree-root: is the top node of the chain of parents. 

• origin: is the property that lets one know the origin of the node. The root doesn’t 
have this property. 

• origin-to-subnode-rel-property-name: indicates the nodes for which the node is the 
origin when the node is not the grove root. 

The data and children properties are known as content properties. Every class will have 
either a children property or a data property, but not both. Using the content property, it 
is possible to extract the data which are the concatenation of the data produced by each 
of the children, possibly separated as indicated by the data separator property. 

The origin of a node is not its parent. When a node has a parent, origin and parent will 
be the same. But there are nodes that don’t have a parent, and they still have an origin. 
Only the root node doesn’t have an origin. One node has a parent when it is placed in 
the content nodal property (or children property) of its parent, becomming then a child 
of its parent. When a node is placed in a property other than the children property, it 
has no parent, it doesn’t become a child, and thus it only has an origin. 

4.5. Grove Plans 

Once the property set has been defined, the full grove, which would be constructed 
using all the classes and properties of the property set, is determined. 

It is possible that for a concrete application or for a concrete process, not all the classes 
and properties are needed. A grove plan is a specification of the modules, classes and 
properties that one wants included in the grove that one builds. The definition of mod- 
ules permits the inclusion of all the definitions of the module as a whole. Grove plans 
are used both to construct groves and to obtain views of existing groves. When a part 
of the property set is not included in the grove plan, it has the same effect for the 
application as if the excluded definitions did not exist. 
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In DSSSL the grove plan may only indicate which modules to include, not the classes 
or properties. There is a group of modules that are included automatically to guarantee 
a minimum processing capability. 

4.6. The SGML Property Set 

With the information above it is possible to read clause 9 of the DSSSL standard or the 
Property Set Definition Requirements annex of ISO/IEC 10744 (HyTime). In both ref- 
erences a guide to the understanding of property sets is given followed by the definition 
of the SGML property set. 

Given that DSSSL only allows the grove plan to include entire modules, the following 
will indicate the modules defined in the SGML property set. 

• baseabs: base abstract classes and properties (page 86 of the standard) 

• prlgabsO: prolog-related abstract classes and properties, level 0 (page 88 of the stan- 
dard) 

• instabs: document instance-related abstract classes and properties 

• basesdsO: base classes and properties of the SGML document text, level 0 (page 91 
of the standard) 

• basesdsl: base classes and properties of the SGML document text, level 0 (page 92 
of the standard) 

• sdclabs: abstract classes and properties related to the SGML declaration (page 98 of 
the standard) 

• sdclsds: classes and properties of the SGML document text related to the SGML 
declaration (page 103 of the standard) 

• prlgabsl : prolog-related abstract classes and properties, level 1 (page 104 of the stan- 
dard) 

• prlgsds: prolog-related classes and properties of the SGML document text (page 108 
of the standard) 

• instsdsO: document instance-related classes and properties of the SGML document 
text, level 0 (page 1 10 of the standard) 

• instsdsl: document instance-related classes and properties of the SGML document 
text, level 1 (page 1 10 of the standard) 

• dtgabs: datatag-related abstract classes and properties (page 1 12 of the standard) 

• rankabs: rank-related abstract classes and properties (page 1 13 of the standard) 

• srabs: shortref-related abstract classes and properties (page 1 13 of the standard) 

• srsds: shortref-related classes and properties of the SGML document text (page 114 
of the standard) 

• linkabs: link-related abstract classes and properties (page 1 15 of the standard) 
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• linksds: link-related classes and properties of the SGML document text (page 1 19 of 
the standard) 

• subdcabs: subdoc-related abstract classes and properties (page 120 of the standard) 

• subdcsds: subdoc-related classes and properties of the SGML document text (page 
120 of the standard) 

• fpiabs: formal public identifier-related abstract classes and properties (page 121 of 
the standard) 

There are dependency relationships between the modules of the SGML propset, which 
means that including one module will also include the list of modules on which it 
depends. 
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Figure 4-1. Dependencies Between Modules 
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4.7. The Grove 

Once the desired modules have been selected by means of the grove plan, construction 
of the grove for a document instance may begin. 

The manner in which a grove is implemented is unspecified. It is desirable that a grove 
implementation be as efficient as possible and that it conforms to the definitions of the 
property set. Tutorials on DSSSL [DSSSLtut], HyTime [Hytut] and Groves [Grovetut] 
are available on the internet, some of which show graphic representations of groves. 
These pictures should be viewed solely as options or proposals, but never as something 
normative. 

Regardless, there are some rules that all implementations must follow. The classes de- 
fined in the property set become nodes. The properties defined in the property set be- 
come attributes of the nodes. The values that these attributes take depend on firstly the 
data types assigned to the property in the property set and secondly on the document 
instance. 

There are some categories defined in the property set that affect classes and properties 
in the transformation process. See Section 6.5.6 

• mayadd identifies a category of classes that can be added automatically by the pro- 
cessor after tha transformations take place. 

• derived identifies a category of properties that do not come from the syntax but from 
the document as a whole. For example, the list of unique IDs of the document can 
only be known once the document has been processed completely. A derived prop- 
erty is any property that is computed based on information from various parts of 
the document. In the transformation process the programmer must not bother with 
properties in this category as they are generated at the end of the transformation 
automatically from the final content of the transformed document. 

• optional identifies a category of classes that can have a null value after the transfor- 
mation. 



4.8. Classes of the SGML Propset 

In this section the SGML property set definitions are compiled in a clear and compre- 
hensible manner using tables. Several coding conventions are used in the tables. 

• When a nodal datatype is of type irefnode type, it will be preceded by an arrow 

• The content property of the class, if there is any, will be emphasized in italics. 

• Mayadd category will be indicated at the beginning of the class. 

• Derived and Optional categories will be marked D and O in the C(ategory) column. 

• The when column specifies conditions that shall be satisfied for a node to exhibit 
a value with the declared data type; if this condition is not satisfied, the node shall 
exhibit a null value for this property. 
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4.8.1. Class SGML-DOCUMENT 

Defined in the baseabs module. 

The root of the grove. 

Table 4-1. Properties of SGML-DOCUMENT in baseabs 



Property 


Datatype 


Subnodes 


When 


sgml-constants 


node-list 


sgml-constants 




application-info 


string 




declaration includes value for 
APPINFO 


Prolog 


node-list 


doctpdcl, link-type-decl, 
comment-decl, pi, s-sep 




epilog 


node-list 


comment-decl, pi, s-sep 





Table 4-2. Properties of SGML-DOCUMENT in prlgabsO 



Property 


Datatype 


Subnodes 


Desc 


goveming- 

doctype 


-^node-list 


document-type 


a separate SGML-DOCUMENT grove 
is created for each active DTD, thus 
supporting concurrent markup 


doctypes-and- 

linktypes 


nmndlist 


document-type, 

link-type 


declarations in the prolog 



Table 4-3. Properties of SGML-DOCUMENT in instabs 



Property 


Datatype 


Subnodes 


Desc 


document- 

element 


node-list 


element 


top-most element representing the DTD 


elements 


— >nmndlist 


element 


all the elements with unique IDs in the 
document 


entities 


^nmndlist 


entity 


internal and external entities declared in the 
DTD, followed by the defaulted entities. 
Unnamed entities not included 


defaulted-entities 


nmndlist 


entity 





Table 4-4. Properties of SGML-DOCUMENT in sdclabs 



Property 


Datatype 


Subnodes 


Desc 


sgml- version 


string 




first parameter of declaration 


document-char-set 


node-list 


char-set 
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Table 4-4 (cont). Properties of SGML-DOCUMENT in sdclabs 



Property 


Datatype 


Subnodes 


Desc 


capacity-set 


node-list 


capacity-set 




syntax-scope 


enum -> instance, 
document 






decl- syntax 


node-list 


syntax 




ref- syntax 


node-list 


syntax 


the reference concrete syntax 
and, if scope = INSTANCE, 
the prolog 


prolog- syntax 


— >node-list 


syntax 




features 


node-list 


features 





Table 4-5. Properties of SGML-DOCUMENT in sdclsds 



C 


Property 


Datatype 


Subnodes 


When 


0 


sgml-decl 


node-list 


sgml-decl 


declaration explicitly present 




sgml-decl-type 


enum -> explicit, 
implicit, inherit 







4.8.2. Class SGML-CONSTANTS 

Defined in the baseabs module. 

A holding pen for selected nodes intrinsic to all SGML documents, which may be 
needed as irefnodes elsewhere. 

Table 4-6. Properties of SGML-CONSTANTS 



Property 


Datatype 


Subnodes 


Module 


empty-short-ref-map 


node-list 


short-ref-map 


srabs 


empty-link- set 


node-list 


link-set 


linkabs 



4.8.3. Class ATTRIBUTE-ASSIGNMENT 

Defined in the baseabs module. 

An attribute assignment, whether specified or defaulted. 
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Table 4-7. Properties of ATTRIBUTE-ASSIGNMENT in baseabs 



Property 


Datatype 


Subnodes 


Desc 


When 


value 


node-list 


attribute- value-token, 
data-char, sdata, 
interp-ignored-char, 
entity-start, entity-end 


tokenized attribute 
values are represented 
using 

attribute-value-tokens 
alone; otherwise, 
children are of the 
other allowed types 


not impliable 
and has no 
attribute 
specification 


name 


string 








implied? 


boolean 




true for impliable 
attributes without 
attribute specification 




token-sep 


char 






two or more 
attribute- 
value-token 
children 



Table 4-8. Properties of ATTRIBUTE-ASSIGNMENT in basesdsl 



Property 


Datatype 


Subnodes 


When 


attribute-spec 


-^node-list 


name, s-sep, general-delim, literal, 
attribute-value 


specified 


attribute-value-spec 


^node-list 


attribute-value, literal 


not implied 



Table 4-9. Properties of ATTRIBUTE-ASSIGNMENT in prlgabsl 



Property 


Datatype 


Subnodes 


attribute-def 


— >node-list 


attribute-def 



4.8.4. Class ATTRIBUTE-VALUE-TOKEN 

Defined in the baseabs module. 

Table 4-10. Properties of ATTRIBUTE- VALUE-TOKEN in baseabs 



Property 


Datatype 


token 


string 



Table 4-11. Properties of ATTRIBUTE- VALUE-TOKEN in instabs 



Property 


Datatype 


Subnodes 


When 


entity 


— »node-list 


entity 


ENTITY or ENTITIES 
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Table 4-11 (cont). Properties of ATTRIBUTE- VALUE-TOKEN in instabs 



Property 


Datatype 


Subnodes 


When 


notation 


-^node-list 


notation 


NOTATION 


referent 


—^node-list 


element 


IDREF or IDREFS 



4.8.5. Class DATA-CHAR 

Defined in the baseabs module. 

Nodes of this class represent the characters in the content of the document. A sequence 
of data-char represents a string of text. 

Table 4-12. Properties of DATA-CHAR in baseabs 



Property 


Datatype 


char 


char 



Table 4-13. Properties of DATA-CHAR in basesdsl 



C 


Property 


Datatype 


Subnodes 


When 




interp-replaced-char 


char 




a character was 
replaced while a literal 
was interpreted 


0 


named-char-ref 


node-list 


general-delim, name, 
ref-end-re 


replacing a named 
character reference 


0 


numeric-char-ref 


node-list 


general-delim, name, 
char-ref-char-number, 
ref-end-re 


replacing a numeric 
character reference 



Table 4-14. Properties of DATA-CHAR in instsdsl 



Property 


Datatype 


Subnodes 


Desc 


When 


moved-re? 


boolean 




true for an RE that was moved 




re-position 


-^node-list 


re-position 


where RE occurred 


RE moved 



Table 4-15. Properties of DATA-CHAR in linkabs 



Property 


Datatype 


Subnodes 


Desc 


When 


link- set-info 


— >node-list 


link-rule 


link rules for implied 
element type 


explicit link process 
active 



4.8.6. Class SDATA 

Defined in the baseabs module. 
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Table 4-16. Properties of SDATA in baseabs 



Property 


Datatype 


When 


system-data 


string 




char 


char 


map-sdata-entity associations present 



Table 4-17. Properties of SDATA in basesdsO 



C 


Property 


Datatype 


Subnodes 


0 


entity-name 


string 






entity 


— >node-list 


entity 



Table 4-18. Properties of SDATA in basesdsl 



C 


Property 


Datatype 


Subnodes 


o 


markup 


node-list 


general-delim, name, s-sep, entity-start, entity-end, 
ref-end-re, short-ref 



4.8.7. Class PI 

Defined in the baseabs module. 
Processing instruction 

Table 4-19. Properties of PI in baseabs 



Property 


Datatype 


system-data 


string 



Table 4-20. Properties of PI in basesdsO 



Property 


Datatype 


Subnodes 


When 


entity-name 


string 




referencing PI entity 


entity 


— j^node-list 


entity 


referencing PI entity 



Table 4-21. Properties of PI in basesdsl 



C 


Property 


Datatype 


Subnodes 


Desc 


When 


0 


entity-ref 


node-list 


general-delim, name, 
s-sep, entity-start, 
entity-end, ref-end-re, 
short-ref 


markup 


referencing PI entity 
with named entity 
reference or short 
reference 


o 


open-delim 


node-list 


general-delim 




not referencing PI 
entity 
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Table 4-21 (cont.). Proi 


Denies of PI in basesdsl 


c 


Property 


Datatype 


Subnodes 


Desc 


When 


0 


close-delim 


node-list 


general-delim 




not referencing PI 
entity 



4.8.8. Class DOCUMENT-TYPE 

Defined in the prlgabsO module. 

the abstraction of a document type declaration 
Note: It includes entities not explicitly declared in the DTD. 

Table 4-22. Properties of DOCUMENT-TYPE in prlgabsO 



Property 


Datatype 


Subnodes 


Desc 


name 


string 




name of the document type and of the top-most 
element 


governing? 


boolean 




true for the active document type or for the base 
document type when no active one 


general- 

entities 


nmndlist 


entity 


Undeclared general entities with a default 
declaration are in the entities property of 
SGML-DOCUMENT. See default-entity 
following. 


notations 


nmndlist 


notation 





Table 4-23. Properties of DOCUMENT-TYPE in prlgabsl 



Property 


Datatype 


Subnodes 


When 


default-entity 


node-list 


default-entity 


default for undeclared entity 
names 


element-types 


nmndlist 


element-type, rank-stem 




parameter-entities 


nmndlist 


entity 





Table 4-24. Properties of DOCUMENT-TYPE in prlgsds 



Property 


Datatype 


Subnodes 


doctpdcl 


— >node-list 


doctpdcl 



Table 4-25. Properties of DOCUMENT-TYPE in srabs 



Property 


Datatype 


Subnodes 


Desc 


short-ref-maps 


nmndlist 


short-ref-map 


 map not included 














Chapter 4. The Process of Grove Construction 



69 



4.8.9. Class ENTITY 

Defined in the prlgabsO module. 

Table 4-26. Properties of ENTITY in prlgabsO 



Property 


Datatype 


Subnodes 


When 


name 


string 






entity-type 


enum-> text, cdata, sdata, ndata, 
subdocument, pi 






text 


string 




internal 


external-id 


node-list 


extemal-id 


external id 


attributes 


nmndlist 


attribute- 

assignment 


external data entity 


notation- 

name 


string 




external data entity 


notation 


-^node-list 


notation 


external data entity 



Table 4-27. Properties of ENTITY in basesdsO 



Property 


Datatype 


defaulted? 


boolean 



Table 4-28. Properties of ENTITY in prlgsds 



Property 


Datatype 


Subnodes 


entity-decl 


— >node-list 


entity-decl 



4.8.10. Class NOTATION 

Defined in the prlgabsO module. 

Table 4-29. Properties of NOTATION in prlgabsO 



Property 


Datatype 


Subnodes 


name 


string 




extemal-id 


node-list 


extemal-id 











70 



Chapter 4. The Process of Grove Construction 



Table 4-30. Properties of NOTATION in prlgabsl 



Property 


Datatype 


Subnodes 


attribute-defs 


nmndlist 


attribute-def 



Table 4-31. Properties of NOTATION in prlgsds 



Property 


Datatype 


Subnodes 


When 


notation-decl 


-^node-list 


notation-decl 




attribute-def-list-decl 


^node-list 


attribute-def-list-decl 


ATTLIST 



4.8.11. Class EXTERNAL-ID 

Defined in the prlgabsO module. 

Table 4-32. Properties of EXTERNAL-ID in prlgabsO 



C 


Property 


Datatype 


When 




public-id 


string 


public identifier 




system-id 


string 


system identifier. 


0 


generated- system-id 


string 


not identifying the default entity 



Table 4-33. Properties of EXTERNAL-ID in fpiabs 



C 


Property 


Datatype 


Subnodes 


When 


0 


formal-public-id 


node-list 


formal-public-id 


FORMAL YES 



4.8.12. Class ELEMENT 

Defined in the instabs module. 

Table 4-34. Properties of ELEMENT in instabs 



C 


Property 


Datatype 


Subnodes 


When 




gi 


string 






D 


id 


string 




ID present 




attributes 


nmndlist 


attribute-assignment 
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Table 4-34 (cont). Pro] 


Gerties of ELEMENT in instabs 


c 


Property 


Datatype 


Subnodes 


When 




content 


node-list 


data-char, sdata, element, external-data, 
subdocument, pi, 

marked- section-ignored-char, ignored-rs, 
ignored-re, re-position, short-ref-use-decl, 
link-set-use-decl, entity-start, entity-end, 
s-sep, comment-decl, marked-section-start, 
marked-section-end, ignored-markup 





Table 4-35. Properties of ELEMENT in prlgabsl 



Property 


Datatype 


Subnodes 


element-type 


-^node-list 


element-type 



Table 4-36. Properties of ELEMENT in instsdsO 



C 


Property 


Datatype 


Desc 


D 


included? 


boolean 


true for included subelements 


D 


must-omit- 

end-tag? 


boolean 


true for omitted end tags because of declared content of 
empty or content reference 



Table 4-37. Properties of ELEMENT in instsdsl 



C 


Property 


Datatype 


Subnodes 


When 


0 


start-tag 


node-list 


general-delim, name, s-sep, entity-start, 
entity-end, literal, attribute- value 


start-tag specified 


0 


end-tag 


node-list 


general-delim, name, s-sep, entity-start, 
entity-end, ignored-markup 


end-tag (not a 
data tag) 
specified 



Table 4-38. Properties of ELEMENT in dtgabs 



C 


Property 


Datatype 


Desc 


D 


datatag? 


boolean 


true for data tags serving as end tags. The data- tag 
characters follow the element in the content of the parent 



Table 4-39. Properties of ELEMENT in linkabs 



C 


Property 


Datatype 


Subnodes 


Desc 


When 


0 


simple-link- 

info 


nmndlist 


simple-link- 

info??? 




element is the 
document element 
and there are active 
simple link 
processes 
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Table 4-39 (cont.). Properties of ELEMENT in linkabs 



c 


Property 


Datatype 


Subnodes 


Desc 


When 




link-attributes 


— ^nmndlist 


attribute- 

assignment 






D 


result-gi 


string 






explicit link rule 
applicable whose 
result element is not 
implied 




result- 

element-type 


-^node-list 


element-type 




explicit link rule 
applicable whose 
result element is not 
implied 




result- 

attributes 


— >nmndlist 


attribute- 

assignment 


the origin of the 
attributes will be 
the link rule 


explicit link rule 
applicable whose 
result element is not 
implied 




link-set-info 


— ^-node-list 


link-rule 


link rules in the 
current link set 
whose source 
element type is 
implied 


explicit link process 
active 



4.8.13. Class EXTERNAL-DATA 

Defined in the instabs module. 

The result of referencing an external data entity 

Table 4-40. Properties of EXTERNAL-DATA in instabs 



Property 


Datatype 


Subnodes 


entity-name 


string 




entity 


-^node-list 


entity 



Table 4-41. Properties of EXTERNAL-DATA in instsdsl 



C 


Property 


Datatype 


Subnodes 


0 


markup 


node-list 


general-delim, name, s-sep, entity-start, entity-end, 
ref-end-re, short-ref 



4.8.14. Class S-SEP 

Defined in the basesdsl module. 
MAYADD category 
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Table 4-42. Properties of S-SEP in basesdsl 



c 


Property 


Datatype 


Subnodes 


When 




char 


char 






0 


named-char- 

ref 


node-list 


general-delim, name, 
ref-end-re 


named character reference 
replaced 



4.8.15. Class COMMENT 

Defined in the basesdsl module. 

Table 4-43. Properties of COMMENT in basesdsl 



C 


Property 


Datatype 


Subnodes 


Desc 


0 


open-delim 


node-list 


general-delim 






chars 


string 




text of the comment 


o 


close-delim 


node-list 


general-delim 





4.8.16. Class COMMENT-DECL 

Defined in the basesdsl module. 

MAYADD category 

Table 4-44. Properties of COMMENT-DECL in basesdsl 



Property 


Datatype 


Subnodes 


markup 


node-list 


comment, s-sep 



4.8.17. Class IGNORED-MARKUP 

Defined in the basesdsl module. 

Ignored markup. Either a start-tag or end-tag whose name is not an active document 
type, or a general or parameter entity reference whose name is not an active document 
or link type, or a link set use declaration whose name is not an active link type, or a 
general entity reference inside ignored markup, or an entity already declared. 

Table 4-45. Properties of IGNORED-MARKUP in basesdsl 



Property 


Datatype 


Subnodes 


markup 


node-list 


general-delim, name, s-sep, attribute-value, literal, entity-start, 
entity-end, ref-end-re 
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4.8.18. Class ENTITY-START 

Defined in the basesdsl module. 

The start of an entity reference replaced by the parser. 

Table 4-46. Properties of ENTITY-START in basesdsl 



c 


Property 


Datatype 


Subnodes 


0 


markup 


node-list 


general-delim, name, s-sep, entity-start, entity-end, 
ref-end-re, short-ref 


0 


entity-name 


string 






entity 


— >node-list 


entity 



4.8.19. Class ENTITY-END 

Defined in the basesdsl module. 

The end of an entity reference replaced by the parser. 



4.8.20. Class MARKED-SECTION-IGNORED-CHAR 

Defined in the basesdsl module. 

A character ignored within a marked section. 

Table 4-47. Properties of MARKED-SECTION-IGNORED-CHAR in basesdsl 



Property 


Datatype 


char 


char 



4.8.21. Class INTERP-IGNORED-CHAR 

Defined in the basesdsl module. 

A character ignored when a literal was interpreted. 

Table 4-48. Properties of INTERP-IGNORED-CHAR in basesdsl 



C 


Property 


Datatype 


Subnodes 


When 


0 


named-char-ref 


node-list 


general-delim, name, 
ref-end-re 


replacing named character 
reference 




char 


char 
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4.8.22. Class GENERAL-DELIM 

Defined in the basesdsl module. 

A general delimiter. 

Table 4-49. Properties of GENERAL-DELIM in basesdsl 



c 


Property 


Datatype 


Subnodes 


When 


0 


named-char-ref 


node-list 


general-delim, name, 
ref-end-re 


first character is a named 
character reference 




role 


string 






0 


original-delim 


string 







4.8.23. Class NAME 

Defined in the basesdsl module. 

A name within markup. 

Note: attribute- value-tokens are used for names in attribute values. 

Table 4-50. Properties of NAME in basesdsl 



Property 


Datatype 


original-name 


string 



4.8.24. Class RESERVED-NAME 

Defined in the basesdsl module. 

Table 4-51. Properties of RESERVED-NAME in basesdsl 



C 


Property 


Datatype 




ref-name 


string 


0 


original-name 


string 



4.8.25. Class LITERAL 

Defined in the basesdsl module. 

A parameter literal, attribute value literal, minimum literal or system identifier. 
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Table 4-52. Properties of LITERAL in basesdsl 



c 


Property 


Datatype 


Subnodes 


0 


open-delim 


node-list 


general-delim 




value 


node-list 


entity-start, entity-end, data-char, sdata, interp-ignored-char 


0 


close-delim 


node-list 


general-delim 



4.8.26. Class NUMBER 

Defined in the basesdsl module. 

A number in markup that is not a character number in a character reference. 

Note: Numbers in attribute values are represented by nodes of type attribute-value-token rather 
than number. 

Table 4-53. Properties of NUMBER in basesdsl 



Property 


Datatype 


digits 


string 



4.8.27. Class CHAR-REF-CHAR-NUMBER 

Defined in the basesdsl module. 

A character number occurring in a character reference. 

Note: The numeric value of the number is determined by the char property of the data-char node. 

Table 4-54. Properties of CHAR-REF- CHAR-NUMBER in basesdsl 



C 


Property 


Datatype 


Desc 


0 


n-digits 


integer 


number of digits 



4.8.28. Class REF-END-RE 

Defined in the basesdsl module. 

An RE in markup that is used as a reference end. 

4.8.29. Class ATTRIBUTE- VALUE 

Defined in the basesdsl module. 

An attribute value specification that is an attribute value rather than an attribute value 
literal. 
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Note: Do not confuse this with the attribute-assignment class. 

Table 4-55. Properties of ATTRIBUTE- VALUE in basesdsl 



Property 


Datatype 


value 


string 



4.8.30. Class NAME-TOKEN 

Defined in the basesdsl module. 

A name token in markup. Used for name tokens in name token groups in declared 
values. 

Note: Name tokens in attribute values are represented by nodes of type attribute-value-token. 

Table 4-56. Properties of NAME-TOKEN in basesdsl 



Property 


Datatype 


original-name-token 


string 



4.8.31. Class MARKED-SECTION-START 

Defined in the basesdsl module. 

The mark-up opening a marked section. 

Table 4-57. Properties of MARKED-SECTION-START in basesdsl 



C 


Property 


Datatype 


Subnodes 


0 


markup 


node-list 


general-delim, reserved-name, s-sep, entity-start, 
entity-end, comment, ignored-markup 




status 


enum-> ignore, cdata, 
rcdata, include, temp 





4.8.32. Class MARKED-SECTION-END 

Defined in the basesdsl module. 

Table 4-58. Properties of MARKED-SECTION-END in basesdsl 



C 


Property 


Datatype 


Subnodes 


o 


markup 


node-list 


general-delim 
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4.8.33. Class CHAR-SET 

Defined in the sdclabs module. 

Table 4-59. Properties of CHAR-SET in sdclabs 



Property 


Datatype 


Subnodes 


char-descs 


node-list 


char-desc 



4.8.34. Class CHAR-DESC 

Defined in the sdclabs module. 

Table 4-60. Properties of CHAR-DESC in sdclabs 



Property 


Datatype 


Desc 


When 


desc- set-number 


integer 






n-chars 


integer 






base-set-number 


integer 




base set character number present 


base-char- set 


string 


public identifier 


base set character number present 


desc-literal 


string 




base set number present 



4.8.35. Class SYNTAX 

Defined in the sdclabs module. 

Table 4-61. Properties of SYNTAX in sdclabs 



Property 


Datatype 


Subnodes 


Desc 


shunchar-controls ? 


boolean 




true if SHUNCHAR 

includes 

CONTROLS 


shunchar 


int-list 






syntax-ref-char-set 


node-list 


char- set 




re 


char 






rs 


char 






space 


char 






added-function-chars 


nmndlist 


added-function-char 




Icnmstrt 


string 






ucnmstrt 


string 






Icnmchar 


string 






ucnmchar 


string 
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Table 4-61 (cont.). Properties of SYNTAX in sdclabs 



Property 


Datatype 


Subnodes 


Desc 


subst-general-names? 


boolean 




true if GENERAL 
YES in NAMECASE 


subst-entity-names? 


boolean 




true if ENTITY YES 
in NAMECASE 


general-delim-assocs 


nmndlist 


delim-role- assoc 


roles 


shortref-delims 


string-list 






syntax-literal-assocs 


nmndlist 


syntactic-literal-assoc 


reserved names 


attcnt 


integer 






attsplen 


integer 






bseqlen 


integer 






dtaglen 


integer 






dtemplen 


integer 






entlvl 


integer 






grpcnt 


integer 






grpgtcnt 


integer 






grplvl 


integer 






litlen 


integer 






namelen 


integer 






normsep 


integer 






pilen 


integer 






taglen 


integer 






taglvl 


integer 







4.8.36. Class ADDED-FUNCTION-CHAR 

Defined in the sdclabs module. 

Table 4-62. Properties of ADDED-FUNCTION-CHAR in sdclabs 



Property 


Datatype 


Desc 


name 


string 




class 


enum-> funchar, msichar, msochar, msschar, sepchar 




char 


char 


function 

character 
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4.8.37. Class DELIM-ROLE-ASSOC 

Defined in the sdclabs module. 

The association between a string and a delimiter role. 

Table 4-63. Properties of ADDED-FUNCTION-CHAR in sdclabs 



Property 


Datatype 


Desc 


role 


string 


role name 


delim 


string 


string in document 



4.8.38. Class SYNTACTIC-LITERAL-ASSOC 

Defined in the sdclabs module. 

The association between a reserved name and a literal. 

Table 4-64. Properties of SYNTACTIC-LITERAL-ASSOC in sdclabs 



Property 


Datatype 


syntactic-literal 


string 


reserved-name 


string 



4.8.39. Class CAPACITY-SET 

Defined in the sdclabs module. 

Table 4-65. Properties of CAPACITY-SET in sdclabs 



Property 


Datatype 


totalcap 


integer 


entcap 


integer 


entchcap 


integer 


elemcap 


integer 


grpcap 


integer 


exgrpcap 


integer 


exnmcap 


integer 


attcap 


integer 


attchcap 


integer 


avgrpcap 


integer 


notcap 


integer 


notchcap 


integer 
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Table 4-65 (cont.). Properties of CA PACITY-SET in sdclabs 



Property 


Datatype 


idcap 


integer 


idrefcap 


integer 


mapcap 


integer 


Iksetcap 


integer 


Iknmcap 


integer 



4.8.40. Class FEATURES 

Defined in the sdclabs module. 

Table 4-66. Properties of FEATURES in sdclabs 



Property 


Datatype 


Desc 


datatag? 


boolean 


true if DATATAG YES 


omittag? 


boolean 


true if OMITTAG YES 


rank? 


boolean 


true if RANK YES 


shorttag? 


boolean 


true if SHORTTAG YES 


simple 


integer 


0 if SIMPLE NO 


implicit? 


boolean 


true if IMPLICIT YES 


explicit 


integer 


0 if EXPLICIT NO 


concur 


integer 


0 if CONCUR NO 


subdoc 


integer 


0 if SUBDOC NO 


formal? 


boolean 


true if FORMAL YES 



4.8.41. Class SGML-DECL 

Defined in the sdclsds module. 

Table 4-67. Properties of SGML-DECL in sdclsds 



Property 


Datatype 


Subnodes 


markup 


node-list 


s-sep, comment, name, number, reserved-name, literal, 
general-delim 



4.8.42. Class ELEMENT-TYPE 

Defined in the prlgabsl module. 
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Table 4-68, Properties of ELEMENT-TYPE in prlgabsl 



Property 


Datatype 


Subnodes 


Desc 


When 


gi 


string 








omit-start- 

tag? 


boolean 




true if start-tag 
minimization "o" 


omitted tag 

minimization specified 


omit-end-tag? 


boolean 




true if end-tag 
minimization "o" 


omitted tag 

minimization specified 


content-type 


enum-> cdata, 
rcdata, empty, 
any, model-group 




Declared content 




model-group 


node-list 


model-group 




content model has 
model group 


exclusions 


string-list 






content-type is any or 
model-group 


inclusions 


string-list 






content-type is any or 
model-group 


attribute-defs 


nmndlist 


attribute-def 







Table 4-69. Properties of ELEMENT-TYPE in prlgsds 



Property 


Datatype 


Subnodes 


When 


element-type-decl 


-^node-list 


element-type-decl 




attribute-def-list-decl 


— >node-list 


attribute-def-list-decl 


associated ATTLIST 



Table 4-70. Properties of ELEMENT-TYPE in dtgabs 



Property 


Datatype 


When 


data-tag-templates 


string-list 


model group is data tag group 


data-tag-padding- 

template 


string 


model group is data tag group with padding template 



Table 4-71. Properties of ELEMENT-TYPE in rankabs 



C 


Property 


Datatype 


Desc 


When 


D 


rank- suffix 


string 




rank suffix included 




rank- stem 


string 




ranked element or ranked group used 
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c 


Property 


Datatype 


Desc 


When 




rank-group 


string-list 


rank stems in 
ranked group 


ranked group included 



Table 4-72. Properties of ELEMENT-TYPE in srabs 



Property 


Datatype 


Subnodes 


When 


short-ref-map-name 


string 




short reference map associated 


short-ref-map 


-^node-list 


short-ref-map 


short reference map associated 



4.8.43. Class MODEL-GROUP 

Defined in the prlgabsl module. 

A model group or a datatag group. 

Note: A data tag group is represented by a seq connectoing an element-token and a pcdata-token. 

Table 4-73. Properties of MODEL-GROUP in prlgabsl 



Property 


Datatype 


Subnodes 


When 


connector 


enum-> and, or, seq 






occur-indicator 


enum-> opt, plus, rep 




occurrence 
indicator present 


content-tokens 


node-list 


model-group, pcdata-token, 
element-token 





4.8.44. Class PCDATA-TOKEN 

Defined in the prlgabsl module. 

4.8.45. Class ELEMENT-TOKEN 

Defined in the prlgabsl module. 

Table 4-74. Properties of ELEMENT-TOKEN in prlgabsl 



Property 


Datatype 


When 


gi 


string 




occur-indicator 


enum-> opt, plus, rep 


occurrence indicator present 



4.8.46. Class ATTRIBUTE-DEF 

Defined in the prlgabsl module. 
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Table 4-75. Properties of ATTRIBUTE-DEF in prlgabsl 



Property 


Datatype 


Subnodes 


Desc 


When 


name 


string 








decl-value-type 


enum-> cdata, 
entity, entities, id, 
idref, idrefs, name, 
names, nmtoken, 
nmtokens, number, 
numbers, nutoken, 
nutokens, notation, 
name-token-group 








tokens 


string-list 




allowed tokens 


declared value is 
a name token 
group or a 
notation 


default-value- 

type 


enum-> value, 
fixed, required, 
current, conref, 
implied 








default-value 


node-list 


attribute- 

value-token, 

data-char, 

sdata, interp- 

ignored-char, 

entity- start, 

entity-end 




attribute value 
specified 


current-group 


^node-list 


attribute-def 


attributes sharing 
current value 


CURRENT 
default value type 


current- 

attribute-index 


integer 




count of previous 
attributes with 
value type of 
current 


CURRENT 
default value type 



Table 4-76. Properties of ATTRIBUTE-DEF in prlgsds 



Property 


Datatype 


Subnodes 


When 


attribute-value- 

spec 


— >node-list 


attribute-value, 

literal 


default value includes attribute value 
specification 
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4.8.47. Class DEFAULT-ENTITY 

Defined in the prlgabsl module. 

Table 4-77. Properties of DEFAULT-ENTITY in prlgabsl 



Property 


Datatype 


Subnodes 


When 


entity-type 


enum-> text, cdata, sdata, ndata, 
subdocument, pi 






text 


string 




internal entity declared 


extemal-id 


node-list 


extemal-id 


external entity declared 


attributes 


nmndlist 


attribute- 

assignment 


external entity declared 


notation- 

name 


string 




external entity declared 


notation 


— >node-list 


notation 


external entity declared 



Table 4-78. Properties of DEFAULT-ENTITY in prlgsds 



Property 


Datatype 


Subnodes 


entity-decl 


— >node-list 


entity-decl 



4.8.48. Class DOCTPDCL 

Defined in the prlgsds module. 

MAYADD category 

Table 4-79. Properties of DOCTPDCL in prlgsds 



Property 


Datatype 


Subnodes 


When 


markup 


node-list 


s-sep, comment, name, reserved-name, literal, 
marked-section-start, marked-section-end, 
marked-section-ignored-char, entity- start, 
entity-end, comment-decl, pi, 
element-type-decl, entity-decl, notation-decl, 
attribute-def-list-decl, short-ref-use-decl, 
short-ref-map-decl 




document- 

type 


— »node-list 


document-type 
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Table 4-79 (cont.). Properties of DOCTPDCL in prlgsds 



Property 


Datatype 


Subnodes 


When 


entity 


node-list 


entity 


external identifier 
included 



4.8.49. Class ATTRIBUTE-DEF-LIST-DECL 

Defined in the prlgsds module. 

MAYADD category 

Table 4-80. Properties of ATTRIBUTE-DEF-LIST-DECL in prlgsds 



Property 


Datatype 


Subnodes 


Desc 


markup 


node-list 


s-sep, comment, entity-start, entity-end, 
general-delim, name, name-token, 
attribute-value, literal 




assoc- 

element- 

types 


— >node-list 


element-type 


elements including 
same ATTLIST 


assoc- 

notations 


->node-list 


notation 





4.8.50. Class ELEMENT-TYPE-DECL 

Defined in the prlgsds module. 

MAYADD category 

Table 4-81. Properties of ELEMENT-TYPE-DECL in prlgsds 



Property 


Datatype 


Subnodes 


markup 


node-list 


s-sep, comment, entity-start, entity-end, general-delim, name, 
number 


element-type 


node-list 


element-type 



4.8.51. Class ENTITY-DECL 

Defined in the prlgsds module. 

MAYADD category 

An entity declaration that is not ignored. 
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Table 4-82. Properties of ENTITY-DECL in prlgsds 



Property 


Datatype 


Subnodes 


markup 


node-list 


entity-start, entity-end, s-sep, comment, general-delim, name, 
reserved-name, literal, attribute-value 


entity 


-^node-list 


entity 



4.8.52. Class NOTATION-DECL 

Defined in the prlgsds module. 

MAYADD category 

Table 4-83. Properties of NOTATION-DECL in prlgsds 



Property 


Datatype 


Subnodes 


markup 


node-list 


entity-start, entity-end, s-sep, comment, literal, name, 
reserved-name 


notation 


-^node-list 


notation 



4.8.53. Class IGNORED-RS 

Defined in the instsdsl module. 

An RS ignored because of the rules in 7.6.1 of ISO 8879. 

Table 4-84. Properties of IGNORED-RS in instsdsl 



Property 


Datatype 


Subnodes 


When 


named-char-ref 


node-list 


general-delim, name, ref-end-re 


named character 
reference replaced 



4.8.54. Class IGNORED-RE 

Defined in the instsdsl module. 

An RE in content ignored because of the rules in 7.6.1 of ISO 8879. 

Note: This occurs at the point where the RE originally occurred rather than at the point it was 
determined that the RE should be ignored. 

Table 4-85. Properties of IGNORED-RE in instsdsl 



C 


Property 


Datatype 


Subnodes 


When 


o 


named-char-ref 


node-list 


general-delim, name, ref-end-re 


named character 
reference replaced 
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4.8.55. Class RE-POSITION 

Defined in the instsds 1 module. 

The original position of an RE that was moved by the rules of clause 7.6.1 of ISO 8879. 
Note: For each node of type re-position, there will be a node of type data-char with a property 
moved-re? that is true. 



Table 4-86. Properties of RE-POSITION in instsdsl 



Property 


Datatype 


Subnodes 


Desc 


record-end 


-^node-list 


data-char 


character for which this is the re-position 



4.8.56. Class RANK-STEM 

Defined in the rankabs module. 

Table 4-87. Properties of RANK-STEM in rankabs 



Property 


Datatype 


Subnodes 


Desc 


stem 


string 




name 


element-types 


— >node-list 


element-type 


element types using rank stem 



4.8.57. Class SHORT-REF-MAP 

Defined in the srabs module. 

Table 4-88. Properties of SHORT-REF-MAP in srabs 



Property 


Datatype 


Subnodes 


When 


name 


string 




not  map 


map 


nmndlist 


short-ref-assoc 





4.8.58. Class SHORT-REF-ASSOC 

Defined in the srabs module. 

Table 4-89. Properties of SHORT-REF-ASSOC in srabs 



Property 


Datatype 


Subnodes 


short-ref 






entity-name 






entity 


— »node-list 


entity 
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4.8.59. Class SHORT-REF-USE-DECL 

Defined in the srsds module. 

Table 4-90. Properties of SHORT-REF-USE-DECL in srsds 



Property 


Datatype 


Subnodes 


Desc 


When 


markup 


node-list 


entity-start, 
entity-end, s-sep, 
comment, 
general-delim, 
name, 

reserved-name, 

ignored-markup 






assoc- 

element-types 


-^node-list 


element-type 


Note: element 
types already 
associated with a 
map not included 


associated element 
type included 


srmap 


— ^-node-list 


short-ref-map 







4.8.60. Class SHORT-REF 

Defined in the srsds module. 



Table 4-91. Properties of SHORT-REF in srsds 



C 


Property 


Datatype 


Subnodes 


When 




original-delim 


string 






0 


named-char-ref 


node-list 


general-delim, name, 
ref-end-re 


first character is a named 
character reference 



4.8.61. Class SHORT-REF-MAP-DECL 

Defined in the srsds module. 

MAYADD category 

Table 4-92. Properties of SHORT-REF-MAP-DECL in srsds 



Property 


Datatype 


Subnodes 


markup 


node-list 


entity-start, entity-end, s-sep, comment, general-delim, name, 
reserved-name, literal 


map 


— >node-list 


short-ref-map 








90 



Chapter 4. The Process of Grove Construction 



4.8.62. Class SIMPLE-LINK-INFO 

Defined in the linkabs module. 



Table 4-93. Properties of SIMPLE-LINK-INFO in linkabs 



Property 


Datatype 


Subnodes 


Desc 


link-type 


string 




name of simple link process 


attributes 


nmndlist 


attribute- assignment 





4.8.63. Class LINK-TYPE 

Defined in the linkabs module. 

Table 4-94. Properties of LINK-TYPE in linkabs 



Property 


Datatype 


Subnodes 


When 


name 


string 






active? 


boolean 






link-type-kind 


enum-> simple, 
implicit, explicit 






source-document-type-name 


string 






source-document-type 


— >node-list 


document-type 




result-document-type-name 


string 






result-document-type 


— >node-list 


document-type 


explicit link type 


initial-link-set 


node-list 


link-set 


not simple 


id-link- set 


node-list 


link-set 


ID link set declaration 
included 


link- sets 


nmndlist 


link-set 





Table 4-95. Properties of LINK-TYPE in linksds 



Property 


Datatype 


Subnodes 


link-type-decl 


-^node-list 


link-type-decl 



4.8.64. Class LINK-SET 



Defined in the linkabs module. 
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Table 4-96. Properties of LINK-SET in linkabs 



Property 


Datatype 


Subnodes 


When 


name 


string 




not #INITIAL nor  nor the ID link set 


link-rules 


node-list 


link-rule 





Table 4-97. Properties of LINK-SET in linksds 



Property 


Datatype 


Subnodes 


When 


link-set-decl 


-^node-list 


link-set-decl, id-link-set-decl 


not#EMPTY 



4.8.65. Class LINK-RULE 

Defined in the linkabs module. 

Table 4-98. Properties of LINK-RULE in linkabs 





Property 


Datatype 


Subnodes 


When 


■ 








not an explicit link rule with implied 
source element type 




assoc- 

element-types 


— >node-list 


element-type 


not an explicit link rule with implied 
source element type 




id 


string 




inside ID link set declaration 




uselink 


— >node-list 


link-set 


USELINK included 




uselink-name 


string 




USELINK included 


D 


postlink- 

restore? 


boolean 








postlink-set 


— >node-list 


link-set 


#RESTORE not specified 










POSTLINK included 




link-attributes 


nmndlist 


attribute- 

assignment 


not an explicit link rule whose source 
element type is implied 




result-gi 


string 




explicit link rule whose result element 
type is not implied 




result- 

element-type 


— >>node-list 


element-type 


explicit link rule whose result element 
type is not implied 
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Table 4-98 (cont.). Properties of LINK-RULE in linkabs 



c 


Property 


Datatype 


Subnodes 


When 




result- 

attributes 


nmndlist 


attribute- 

assignment 


explicit link mle whose result element 
type is not implied 



4.8.66. Class LINK-TYPE-DECL 

Defined in the linksds module. 

MAYADD category 

Table 4-99. Properties of LINK-TYPE-DECL in linksds 



Property 


Datatype 


Subnodes 


When 


markup 


node-list 


s-sep, comment, name, reserved-name, 
literal, marked-section-start, 
marked-section-ignored-char, 
marked- section-end, entity- start, 
entity-end, pi, comment-decl, entity-decl, 
attribute-def-list-decl, link-set-decl, 
id-link-set-decl 




link-type 


irefnode 


link-type 




entity 


node-list 


entity 


external identifier 
included 



4.8.67. Class LINK-SET-DECL 

Defined in the linksds module. 

MAYADD category 

Table 4-100. Properties of LINK-SET-DECL in linksds 



Property 


Datatype 


Subnodes 


markup 


node-list 


entity-start, entity-end, s-sep, comment, general-delim, name, 
reserved-name, literal, attribute-value 


link- set 


— >-node-list 


link-set 



4.8.68. Class ID-LINK-SET-DECL 

Defined in the linksds module. 

MAYADD category 
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Table 4-101. Properties of ID-LINK-SET-DECL in linksds 



Property 


Datatype 


Subnodes 


markup 


node-list 


entity-start, entity-end, s-sep, comment, general-delim, name, 
reserved-name, literal, attribute-value 


link-set 


— >node-list 


link-set 



4.8.69. Class LINK-SET-USE-DECL 

Defined in the linksds module. 

A link set use declaration that is not ignored. 

Table 4-102. Properties of LINK-SET-USE-DECL in linksds 



C 


Property 


Datatype 


Subnodes 


When 




markup 


node-list 


entity-start, entity-end, s-sep, 
comment, general-delim, name, 
reserved-name, ignored-markup 




D 


restore? 


boolean 








linkset 


-^node-list 


link-set 


#RESTORE not 
specified 




Iksetnm 


string 








link-type-name 


string 








link-type 


— )>node-list 


link-type 





4.8.70. Class SUBDOCUMENT 

Defined in the subdcabs module. 

The result of referencing a subdocument entity. 

Table 4-103. Properties of SUBDOCUMENT in subdcabs 



Property 


Datatype 


Subnodes 


entity-name 


string 




entity 


-^node-list 


entity 



Table 4-104. Properties of SUBDOCUMENT in subdcsds 



C 


Property 


Datatype 


Subnodes 


o 


markup 


node-list 


general-delim, name, s-sep, entity-start, entity-end, 
ref-end-re, short-ref 
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4.8.71. Class FORMAL-PUBLIC-ID 

Defined in the fpiabs module. 

The string without "+//" or s characters. 

Table 4-105. Properties of FORMAL-PUBLIC-ID in fpiabs 



Property 


Datatype 


When 


owner-type 


enum-> iso, registered, unregistered 




owner-id 


string 




text-class 


enum-> capacity, char-set, 
document, dtd, elements, entities, 
Ipd, nonsgml, notation, short-ref, 
subdocument, syntax, text 




unavailable? 


boolean 




text-description 


string 




text-language 


string 


public text language included 


text-designating- 


string 


public text designating sequence 


sequence 




included 


text-display- 

version 


string 


public text display version included 



4.8.72. Graphical Examples 

The preceding tables gather together the definitions of the classes and properties of the 
SGML propset. Depending on the modules included in the grove plan, all or some of 
the classes and properties shown here will be accessible. The DSSSL grove plan auto- 
matically includes the modules baseabs, prlgabsO, instabs and, for the transformation 
language, prlgabsl as well. This means including: 

• baseabs -i- prlgabsO -i- instabs for the style process: sgml-document, sgml-constants, 
attribute-assignment, attribute- value-token, data-char, sdata, pi, document- type, en- 
tity, notation, external-id, element, external-data 

• + prlgabsl for the transformation process: element- type, model-group, pcdata-token, 
element-token, attribute-def, default-entity 

In the graphic below there is a schema of all the classes and attributes supported in 
the automatically included grove plan in the formatting process. For a concrete SGML 
document only a subset of the classes and relations shown will take place. The figure 
is the join of all possibilities allowed in the grove plan, and as such is only a graphic of 
potential relations between classes. Afterwards an example of a grove will be offered. 
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Figure 4-2. Default grove plan for the formatting process 




Another graphic can be constructed with all the possibilities allowed by the automati- 
cally included grove plan for the transformation process. 
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The two complex figures above can be confusing, although they are only a graphical 
representation of the propset definitions. With the intention of clearing the concepts, 
as a last example, the structure of the grove representing a simple SGML document is 
offered. It follows the formatting process default grove plan. 

Example 4-2. Grove for an SGML document 

The SGML document is: 

<!DOCTYPE book PUBLIC "-/ /OASIS/ /DTD DocBook V4 . 2CR1 / /EN" [ 

<book lang="es"> 

<title>tit</title> 

<chapter id="Cl"> 

<title>A</title> 

<para>PP< /para> 

</chapter> 

</book> 




An inconvenience of property sets is that they are intended to be read by people and not 
for automatic processing. For example, there are when elements that contain conditions 
explained in natural language. This means that it is not possible to create a program that 
compiles a property set and automatically generates a grove model; this must be done 
by hand. At least it only has to be done once. 

Those who whish to learn more can consult clause 9 of the DSSSL standard which, 
after this introduction, will be easy to understand, and see there the definition of the 
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SGML property set. Furthermore, there are programs which allow the visualization of 
groves, for example Grove View. 




Chapter 5. The Standard Document 
Query Language (SDQL) 



5.1. Introduction 

Once a grove representing the document instance has been constructed, a data model 
containing all the information present in the document is available. By means of the 
query language it is possible to navigate and inspect the grove structure and to select 
nodes from the grove in order to process them later in some way. 

The query language, in its entirety, is available to the transformation process. In the 
formatting process, by default, only a part of the query language, the core query lan- 
guage, is available. If the whole query language is needed for a concrete formatting 
process, the query characteristic has to be used in the features element of the DSSSL 
style specification. 

The query language is designed to be the component that allows to find nodes in the 
grove to apply they later transformations or style rules. In the DSSSL processing model 
there is always at least one of the two processes, be it transformation or style. But with- 
out much effort the query language can be imagined as an isolated component capa- 
ble of querying a wide range of document databases structured following the groves 
paradigm. 

5.2. Query Language Datatypes 

Apart from the standard data types introduced in Chapter 3, the query language intro- 
duces two more datatypes, to represent the node-list and nmndlist data types introduced 
by the SGML property set. 
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5.2.1. Node Lists 

The node-list datatype represents an ordered list of zero or more nodes in the grove. 
It is equivalent to common lists, but is composed of nodes from the grove. The node 
data type is not supported, a single node being represented by a node-list of one node 
only. Such a list is called a singleton node-list, represented by snl in the procedure 
definitions. 



5.2.1. 1. Node Lists Primitive Procedures 

node-list 



(node-list nl^ . . . ) 

Returns a node-list appending nl^ .... Without arguments, returns the empty 
node-list. 

node-list? 

(node-list? ob j ) 

Returns #t when obj is a node-list. 

node-list-empty? 

(node- list -empty? nl) 

Returns #t when the node-list nl is the empty node-list. 

node-list-first 



(node-list-first nl) 



Returns the first node of nl on a singleton node-list. If nl is the empty node-list, 
the empty node-list is returned. It is the node-list equivalent of the car for lists. 
See Also: car. 

node-list-rest 



(node-list-rest nl) 



Returns all the elements of nl except the first. If nl is the empty node-list, the 
empty node-list is returned. It is the node-list equivalent to the cdr function for 
lists. 

See Also: cdr. 

node-list=? 



(node-list=? nl^ nl^) 
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Returns #t when nl and nl contain the same nodes in the same order. 

1 2 

node-list-no-order 

(node-list-no-order nl) 

Returns a node-list that has the same nodes as nl but in an unspecified order. 

5.2.1. 2. Derived Procedures 

empty-node-list 

(empty-node -list) 

Returns an empty node-list. 

node-list-reduce 

(node-list-reduce nl proc ob j ) 

The node-list equivalent of the reduce function for lists. 

See Also: reduce. 

node-list-contains? 

(node-list-contains? nl snl) 

Returns #t when node snl is in node-list nl. 

node-list-remove-duplicates 

(node-list-remove-duplicates nl) 

Returns a node- list where sequences of equal nodes in nl are reduced to one node. 
It only removes equal nodes that are contiguous. Equal nodes separated by other 
nodes are not removed. 

node-list-union 

(node-list-union #!rest args) 

Returns a node-list composed of the elements of the argument node-lists. 

node-list-intersection 

(node-list-intersection #!rest args) 



Returns a node-list composed of the nodes that are common to all argument node- 
lists. Only one copy of each node is returned. 
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node-list-difference 



(node-list-difference # ! rest args) 

Returns a node-list composed of those nodes of the first argument node-list that 
don’t occur in any of the rest of argument node-lists. No duplicate nodes are re- 
turned. 

node-list-symmetric-difference 



(node-list-symmetric-dif ference # ! rest args) 



Returns a node-list composed of those nodes that only occur in one of the argu- 
ment node-lists. 

node-list-map 



(node-list -map proc nl) 



The node-list equivalent to the map function for lists. See Section 3.4.5. 
See Also: map. 

node-list-union-map 



(node-list-union-map proc nl) 



Equivalent to the node-list-map, but returns the union of the resulting node-lists 
as a single node-list. 

See Also: union-for-each. 

union-for-each 



(union-for-each var nl expr) 



An alternative to node-list-union-map that avoids the use of lambda. It is equiv- 
alent to (node- list -union -map (lambda (var) expr) nl). Reads 
as “the union of, for each var in nl, expr'\ 

See Also: node-list-union-map. 

node-list-some? 



(node-list-some? proc nl) 

Returns #t when at least one node of nl returns #t when applied to proc. 
See Also: there-exists?. 

there-exists? 



(there-exists? var nl expr) 
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An alternative to node-list-some? that avoids the use of lambda. It is equivalent to 
(node-list-some? (lambda (var) expr) nl) . Reads as “there ex- 
ists a var in nl such that expr'\ 

See Also: node-list-some?. 

node-list-every? 



(node-list-every? proc nl) 



Returns #t when every node of nl returns #t when applied to proc. 
See Also: for-all?. 

for-all? 



(for-all? var nl expr) 



An alternative to node-list-every? that avoids the use of lambda. It is equivalent 
to (node-list-every? (lambda (var) expr) nl ). Reads as “for all 
var in nl, expr'\ 

See Also: node-list-every?. 

node-list-filter 



(node-list-f liter proc nl) 



Returns a node-list with the nodes of nl that return #t when applied to proc. 
See Also: select-each. 

select-each 



(select-each var nl expr) 



An alternative to node-list-filter that avoids the use of lambda. It is equivalent 
to (node-list-filter (lambda (var) expr) nl) . Reads as “select 
each var in n I such that expr'\ 

See Also: node-list-filter. 

node-list->list 



(node-list->list nl) 



Converts the node-list nl into a list of singleton node-lists. 

node-list-length 



(node-list-length nl) 



Returns the number of nodes in nl. 
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node-list-reverse 

(node-list-reverse nl) 

Returns a node-list with the nodes of nl in reverse order. 

node-list-ref 

(node-list-ref nl k) 

Returns a singleton node-list with the A:-th node of nl. Indexing beings at zero. 

node-list-tail 

(node-list-tail nl k) 

Returns a node-list with all but the k first nodes of nl. 

node-list-head 

(node-list-head nl k) 

Returns the first k nodes of nl in a node-list. 

node-list-sublist 

(node-list-sublist nl k^ k^) 

Returns a node-list with the nodes of nl between positions (inclusive) and k^ 
(exclusive). The first index is zero. 

node-list-count 

(node-list-count nl) 

Counts the number of distinct nodes in nl. 

node-list-last 

(node-list-last nl) 

Returns a singleton node-list with the last node in nl. 

node-list-error 

(node-list-error string nl) 

Signals an error in a similar way to the error procedure, with string describing 
the error. 
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5.2.2. Named Node Lists 

The named-node-list data type is a subtype of node-list, and represents a node-list 
where each member has a text property that identifies it uniquely in the list. This is 
the way in which attribute- value pairs are implemented. 

named-node-list? 



(named-node- list? ob j ) 



Returns #t when obj is a named-node-list. 

named-node 



(named-node string nnl) 



Returns a singleton node-list with the node in nnl whose name is string. If 
there is no such node, the empty node-list is returned. 

named-node-list-normalize 



(named-node-list-normalize string nnl symbol) 



Returns string normalized according to the normalization rule of the named- 
node-list nnl applicable to nodes of class symbol. 

named-node-list-names 



(named-node-list-names nnl) 



Returns a list with the names of the nodes of nnl in the same order as in nnl. 



5.3. Node Procedures 

During the processing of a grove, the program usually needs to know which is the node 
that is being processed at a given time. The next two procedures provide this informa- 
tion. The result of each procedure depends on the context in which it is executed. 

current-node 



(current-node) 

Returns the node being processed. 

current-root 



(current -root) 



Returns the root relative to the current node. 
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5.4. Property Procedures 

This section presents the procedures defined by the standard to access node properties. 

All the procedures described in this section return a neutral value when an appropriate 
value cannot be returned. The neutral value will be either the empty node-list or #f 
depending on whether the type of the value being returned is nodal or non-nodal. 



5.4.1. Primitive Procedures 

There is only one procedure that obtains values from properties of nodes. With this 
procedure any query can be written. 

node-property 



(node-property propname snl # ! key default; null: res?:) 

Returns the value snl exhibits in propname. 



• default : is the value returned when propname is not present in snl 

• null : is the value returned when propname exhibits a null value 

• when res? : #t, propname is the res name of the property as specified in 
the SGML property set. Otherwise it will be the application name. In this book 
only the application names are given, because the RCS is too cryptic, and the 
standard offers a more readable application name, and suggests that applications 
use it rather than the res. 

5.4.2. Derived Procedures 

The DSSSL standard offers a set of derived procedures that help the work of the pro- 
grammer. 



node-list-property 

(node-list-property propname nl) 



Returns the mapping of propname over all the nodes of nl. Several of the proce- 
dures to be introduced below are defined in terms of this procedure. 

5.4.3. Base Grove for the Examples 

To explain the procedures DSSSL offers, a grove will be taken for the practical exam- 
ples, and the procedures will be applied to the grove nodes, giving the results in terms 
of the grove. 
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In Figure 5-1 a grove representing an SGML document is given. Boxes represent nodes. 
The name of the class of the node is given in uppercase. In the cases where a node has a 
properties, they are written below the class name in lowercase followed by their values. 
In order to reduce space, data-char nodes are not shown, and text is represented by 
strings. 

Connections between the nodes are content relations unless the connection is labelled 
with the name of the nodal container property, irefnodes are represented by dotted lines. 

Nodes are numbered in the order they appear in the grove. In the explanation of the 
query language procedures the examples will refer to this figure, and the numbered 
nodes resulting from queries will be given. 

Whenever one node from the grove is to be considered the current one, it will be the 
node pointed to by the ( current -node ) procedure in the figure. 

Several of the procedures to be explained in the sections below return node-lists. In the 
examples, node lists are represented by bracketed lists of nodes copied from the tree 
figure. This is intended only as a graphical way of explaining the results. It doesn’t 
imply any concrete implementation. 
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Figure 5-1. Base grove 




• 31 
C1S3P1 
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5.4.4. Procedures on Generic Properties 

There is a set of procedures that are applicable to any grove, because they depend only 
on the intrinsic properties all nodes share in common. Those properties have already 
been explained in Section 4.4. 

origin 



(origin nl) 



Returns the origins of the nodes in nl. All nodes except the root node have an 
origin. The origin of a node is the node where it is contained. A node can only be 
a subnode of one node, its parent. The rest of a node’s relations will be irefnodes. 

Example 5-1. Origin 

(origin (current-node) ) 



( 



ELEMENT 



gi: chapter 



) 



origin-to-subnode-rel 



(origin-to-subnode-rel snl) 

Returns a string with the name of the node property where the snl node is placed 
in his origin. 

Example 5-2. Origin-to-subnode-rel 

(origin-to-subnode-rel (current-node) ) — ^ "content" 

tree-root 



(tree-root nl) 

Returns the roots of the trees where the nodes in nl are contained. Trees are 
formed by nodes in the content properties of other nodes. If a node has no parent, 
the node itself is its tree root. 

Example 5-3. Tree-root 



(tree-root (current -node) ) 





no 



Chapter 5. The Standard Document Query Language ( SDQL) 




grove-root 

(grove-root nl) 

Returns the roots of the groves where the nodes in nl occur. 

Example 5-4. Grove-root 

(grove-root (current-node) ) — >■ 




children 

(children nl) 

Returns the nodes in the children property of the nodes in nl. The children prop- 
erties are those content properties with nodal datatypes. 

Example 5-5. Children 

(children (current -node) ) 




data 



(data nl) 





Chapter 5. The Standard Document Query Language (SDQL) 



111 



Returns a list of strings with the contents of the nodes in nl. If a node has a data 
property, the string conversion of the value of the property is returned. If, on the 
other hand, the node has children, the concatenation of the values of the children 
is returned. A data property is a content property with a non-nodal data type. 

Example 5-6. Data 

(data (current-node)) — ^ "SEC2 C1S2P1 C1S2P2 C1S2P3" 

parent 



(parent nl) 



Returns the nodes containing nl nodes in their children properties. Children prop- 
erties are those content properties with nodal datatypes. 

Example 5-7. Parent 

(parent (current-node) ) — > 



( 



2 

ELEMENT 



gi: chapter 



) 



source 



(source nl) 



Returns the nodes from which each nl node was derived. The source property 
exists only in auxiliary groves, resulting from auxiliary parsing. See Section 5.4.8 

subtree 



(subtree nl) 

Returns each node of nl followed by the subtrees of its children. 

Example 5-8. Subtree 



(subtree (current -node) ) 
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subgrove 

(subgrove nl) 

Returns the lists of nodes rooted in each of nl nodes, starting from the node itself. 

Example 5-9. Subgrove 

(subgrove (current -node) ) — >• 




descendants 

(descendants nl) 

Similar to subtree, but in descendants the root node is excluded. 

Example 5-10. Descendants 

(descendents (current -node) ) 
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ancestors 

(ancestors nl) 

Returns a list with the chain of parents, starting from the tree root, for each node 
in nl. For a root node, ancestors returns the empty node-list. 

Example 5-11. Ancestors 

(ancestors (current -node) ) — > 

/ 





grove-root-path 

(grove-root-path nl) 

Returns the chain of origins from the grove root to the origin of each node in nl. 

Example 5-12. Grove-root-path 

(grove-root-path (current -node) ) — > 




rsiblings 



(rsiblings nl) 
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Returns the reflexive siblings of each node of nl. The reflexive siblings are the 
nodes placed in the same origin-to-subnode-rel property of the node’s origin. 
When a node has no origin, the node is returned. 



Example 5-13. Rsiblings 

(rsiblings (current -node) ) — 



( 




) 



ipreced 



(ipreced nl) 



Returns the immediately preceding sibling of each node in nl, if any. 

Example 5-14. Ipreced 

(ipreced ( current -node ) ) ^ 

) 

ifollow 



( 






ELEMENT 



gi: section 
id: 4 



(ifollow nl) 



Returns the immediately following sibling of each node in nl, if any. 

Example 5-15. Ifollow 

(ifollow ( current -node ) ) — > 



( 



U 

ATTRIBUTE-ASSIGNMENT 



) 



name: status 
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preced 

{preced nl) 

Returns the preceding siblings of each node in nl. 

Example 5-16. Preced 

(preced (current-node) ) — ^ 




follow 

(follow nl) 

Returns the following siblings of each node in ill. 

Example 5-17. Follow 

(follow (current-node)) — > 




grove-before? 

(grove-before snl^ ^^^2^ 

Returns #t when snl^ is placed in the grove before snl^. This procedure uses the 
grove to establish a total ordering relation between the nodes. 

Example 5-18. Grove-before 

(grove-before? (current-node) (ipreced (current-node))) — > #f 

sort-ln-tree-order 

(sort-in-tree-order nl) 

Returns the nodes in nl, which shall be all members of the same tree in the grove, 
sorted in the same order as in the tree. This procedure uses the grove, and more 
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precisely a subtree in the grove, to establish a partial ordering relation between the 
nodes of the tree. 

Example 5-19. Sort-in-tree-order 

(sort-in-tree-order (current -node) (ipreced (current-node) ) ) 



I 

tree-before? 






ELEMENT 



gi: section 



) 



( 



ELEMENT 



gi: section 
id: 4 



(tree-before? snl^ 

Returns #t when snl^ is placed before snl^ in a tree in the grove. This procedure 
uses the grove, and more precisely a subtree in the grove, to establish a partial 
ordering relation between the nodes of the tree. 

(tree-before? (current-node) (ipreced (current-node))) — >■ #f 



tree-before 

(tree-before nl) 

Returns those nodes placed in the tree before each node of nl. 

Example 5-20. Tree-before 

(tree-before (ipreced (current-node))) — > 



f 

property-lookup 

(property- lookup prop snl if-present if-not-present ) 

Applies the if-present procedure to the property prop of the node snl if 
prop exhibits a value. Otherwise it calls the i f -no t -presen t procedure with- 
out arguments. 



( 



ELEMENT 



gi: book 



ELEMENT 



gi: chapter 



) 
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Example 5-21. Property-lookup 

(property-lookup 'attributes (current -node) data error) — ^ "s 

select-by-class 



(select-by-class nl class-name) 



Returns the nodes in nl whose class is class-name. 

Example 5-22. Select-by-class 



(select-by-class (subgrove (current -node) ) 'attribute-assignment) — » 



( 



select-by-property 



u 

ATTRIBUTE-ASSIGNMENT 



name: status 



(select-by-property nl property-name proc) 

Returns the nodes of nl whose non-nodal property property-name exhibits a 
non-null value such that proc, when applied to it, returns #t. 

Example 5-23. Select-by-property 



( select-by-property 

(subgrove (current -node) ) 

' data-property-name 
symbol? ) 

— > (s,s,e,c,2,c,l,s,2,p,l,c,l,s,2,p,2,c,l,s,2,p,3) 



It should be understood that all the nodes above are the data-char nodes con- 
taining the characters. As it is the subgrove of the current element being traversed, 
the first s in the list corresponds to that of the at tribute -assignment node. 

select-by-null-property 



(select-by-null -property nl property-name) 

Returns those nodes in nl with a null value in property-name. This situation 
arises in the cases where the when condition of the property-name definition 
in the SGML property set is not satisfied. 

Example 5-24. Select-by-null-property 

(select-by-null -property (subgrove ( current -node ) ) 'id) — » 
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( 



j.e , IQ , 21 



ELEMENT 




ELEMENT 




ELEMENT 


gi: section 


1 


gi: title 


1 


gi; para 



23 , , 2i 



ELEMENT 




ELEMENT 


gi: para 


f 


gi; para 



I 



select-by-missing-property 



(select-by-missing-property nl property-name) 

Returns those nodes in nl without property-name. When property-name 
is not included by the grove plan, the property will be considered missing or, 
equivalently, property-name will not exhibit a value. This case must be dis- 
tinguished from that of properties that exhibit a null value if the when condition 
is not satisfied. 



Example 5-25. Select-by-missing-property 



(select-by-missing-property (subgrove (current-node)) ' element -type) — ^ 



( 




I 



5.4.5. Composition 

Query procedures can be composed to construct complex queries. As an example of 
these kinds of queries, and with the intention of extending the previous examples, some 
examples are offered below. 

Example 5-26. Composed queries 



(define attribute 
( select -by-class 

( subgrove ( current -node ) ) 
'attribute-assignment) ) 
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(origin attribute) — ^ 




(grove-root-path attribute) 




(children (ipreced (current-node) ) ) — >> 




(descendants (ipreced (current-node) ) ) 
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( 




(node-list-length (descendents (ipreced (current-node)))) 
— >• 19 ; each data-char node counts as one node 

(node-list-f irst (rsiblings (current -node) ) ) — >■ 



( 



7 

ELEMENT 



gi: title 



) 



5.4.6. The Core Query Language 

DSSSL defines a subset of the query language calles the core query language. In the 
style process that will be explained in Chapter 7, this subset is the part of the query 
language used by default. If the whole query language is to be used, it must be explicitly 
specified with the query feature in the features element of the style specification. 

In contrast to the procedures explained above which are generic and use intrinsic prop- 
erties of grove nodes, the procedures described in this section support SGML properties 
such as elements, attributes, entities, notations. 

5.4.6.1. Core Query Language Node Lists 

The core query language is defined so that all node-lists are singleton and only 
contain element nodes. In some procedures the parameter node-list is defaulted to 
(current -node) . 

5.4.6.2. Allowed Procedures 

The core query language introduces a number of procedures, but also permits the use 
of some procedures defined for the whole query language. The reason is that these 
procedures are basic, and without them no processing can be done at all. 

current-node 



See: current-node 
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node-list-empty? 

See: node-list-empty? 

node-list? 

See: node-list? 

parent 

See: parent 

node-list-error 

See: node- list-error 



S.4.6.3. Navigation 
ancestor 



(ancestor string osnl) 

Returns the nearest ancestor of osnl with a gi equal to string, or an empty 
node-list if there is none. 

Example 5-27. Ancestor 

(ancestor "book") ^ 

( 



ELEMENT 



gi: book 



gi 

(gi osnl) 

Returns the gi of osnl, or #f when there is no gi in osnl. 

Example 5-28. Gi 

(gi) — > "section" 

first-child-gi 

( f irst-child-gi osnl) 

Returns the gi of the first child of osnl, or #f if there are no children. 
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Example 5-29. First-child-gi 

( f irst-child-gi ) — » "title" 

id 

(id osnl) 

Returns the id of osnl, or #f if there is no id. 

Example 5-30. Id 

(id) #f 

S.4.6.4. Counting 

child-number 

(child-number snl) 

Returns one plus the number of siblings preceding snl with the same gi as snl. 

(child-number) — ^ 2 

ancestor-child-number 

(ancestor-child-number string snl) 

Returns the child number of the nearest ancestor of snl whose gi is string, or 
# f if there is none. 

Example 5-31. Ancestor-child-number 

(ancestor-child-number "chapter") — ^ 1 

hierarchical-number 

(hierarchical-number list snl) 

Returns a list with the child numbers of the chain of ancestors of snl whose gi 
match those in list in the same order. 

Example 5-32. Hierarchical-number 



(hierarchical-number ' (book chapter) ) 



(1 1) 
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hierarchical-number-recursive 



(hierarchical-number-recursive string snl) 

Returns a list with the child numbers of the chain of ancestor of snl whose gi is 
string. The length of this list is the nesting level of string. 

Example 5-33. Hierarchical-number-recursive 

(hierarchical-number-recursive "chapter") — > (1) 

element-number 



(element -number snl) 



Returns the number of elements before or equal to snl with the same gi as snl. 

Example 5-34. Element-number 

(element-number) — >• 2 

element-number-list 



(element-number-list list snl) 



Returns the element number of each gi in 1 i s t in the context of the preceding 
gi. This procedure is used, for example, to number footnotes sequentially within 
a chapter by using the last number in the list. It could also be used to number 
headings in a document whose dtd lacks container elements. 

Example 5-35. Element-number-list 

(element-number-list '(chapter section)) — ^ (1 2) 

S.4.6.5. Accessing Attribute Vaiues 

attribute-string 



(attribute-string attribute-name osnl) 



Returns the value of attribute-name of osnl, or #f. 

Example 5-36. Attribute-string 

(attribute-string "ID") — > "1.2" 

inherited-attribute-string 



(inherited-attribute-string attribute-name osnl) 
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Returns the value of attribute-name of osnl or of its nearest ancestor, or 
#f. A node is considered ancestor of itself in this procedure. 

Example 5-37. Inherited-attribute-string 

(inherited-attribute-string "status") — ^ "s" 

inherited-element-attribute-string 

(inherited-element-attribute-string attribute-name gi osnl) 

Returns the value of attribute-name of the nearest ancestor of osnl with 
gi for which the attribute is present and not implied, otherwise returns #f. 

Example 5-38. Inherited-element-attribute-string 

(inherited-element-attribute-string "chapter" "id") #f 

S.4.6.6. Testing Current Location 

first-sibling? 

(first-sibling? snl) 

Returns #t when snl is the first sibling with its same gi. 

Example 5-39. First-sibling? 

(first-sibling?) ^ #f 

absolute-first-sibling? 

(absolute-f irst-sibling? snl) 

Returns #t when snl is the first of its siblings. 

Example 5-40. Absolute-first-sibling? 

(absolute-first-sibling?) — ^ #f 

last-sibling? 

(last-sibling? snl) 

Returns #t when snl is the last sibling with its same gi. 

Example 5-41. Last-sibling? 

(last-sibling?) — > #f 
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absolute-last-sibling? 



(absolute-last-sibling? snl) 

Returns #t when snl is the last of its siblings. 

Example 5-42. Absolute-last-sibling? 

(absolute-last-sibling?) — > #f 

have-ancestor? 

(have-ancestor? ancestor-gi snl) 

Returns #t when snl has an ancestor whose gi is ancestor-gi. 

(have-ancestor? list snl) 

Returns #t when snl has a chain of ancestors whose gis match the elements of 
list. 

Example 5-43. Have-ancestor? 

(have-ancestor? "chapter") — > #t 

S.4.6.7. Entities 

snl here denotes the document in which to find the entity. 

entity-public-id 



(entity-public-id entity-name snl) 

Returns the public-id of enti ty-name in the governing document type of snl. 

entity-system-id 



(entity-system-id entity-name snl) 

Returns the system-id of enti ty-name in the governing document type of snl. 

entity-generated-system-id 



(entity-generated-system-id entity-name snl) 

Returns the generated-system-id of entity-name in the governing document 
type of Sill. 
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entity-text 



(entity-text entity-name snl) 

Returns the text of entity-name in the governing document type of snl. 

entity-notation 



(entity-notation entity-name snl) 

Returns the notation of enti ty-name in the governing document type of snl. 

entity-attribute-string 

(entity-attribute-string entity-name attribute-name snl) 

Returns the value of attribute-nameof entity-name in the governing 
document type of snl. 

entity-type 

(entity-type entity-name snl) 



Returns the entity-type of entity-name in the governing document type of 
snl. 

S.4.6.8. Notations 

snl here denotes the document in which to find the notation. 

notation-public-id 



(notation-public-id notation-name snl) 



Returns the public-id of notation-name in the governing document type of 
snl. 

notation-system-id 



(notation-system-id notation-name snl) 



Returns the system-id of notation-name in the governing document type of 
snl. 

notation-generated-system-id 



(notation-generated-system-id notation-name snl) 

Returns the generated- system- id of notation-name in the governing docu- 
ment type of snl. 
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5.4.6.9. Name Normalization 

general-name-normalize 

(general-name-normalize string snl) 

Returns string transformed by the general namecase substitution string nor- 
malization rule of snl grove. 

entity-name-normalize 



(entity-name-normalize string snl) 



Returns string transformed by the entity namecase substitution string normal- 
ization rule of snl grove. 

5.4.7. SGML Property Procedures 

This set of procedures makes use of the SGML property set. The procedures are defined 
with respect to the automatic grove plan as specified by DSSSL. If a grove plan is 
specified, it will be necessary to specify a larger set of high level procedures tailored 
to the grove plan, or to work with lower level procedures. For example, there are no 
procedures defined for the processing of marked sections nor short references. DSSSL 
procedures are not defined for the whole grove, but for the minimal grove. 

attributes 



(attributes nl) 



Returns a list composed by the attributes of each of the nodes of nl. 

Example 5-44. Attributes 

(attributes (current -node) ) — ^ 

( 

attribute 

(attribute attribute-name nl) 



U 

ATTRIBUTE-ASSIGNMENT 



name: status 



Returns those attributes with at tribute -name of nl nodes. 
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Example 5-45. Attribute 

(attribute "status" ( current -node ) ) — > 



( 



element-with-id 



u 

ATTRIBUTE-ASSIGNMENT 



name: status 



(element-with-id id snl) 



Returns a singleton node-list with the element with id in the grove of snl, snl 
defaults to ( current -node ) . 

Example 5-46. Element-with-id 

(element-with-id "4" (grove-root (current-node))) — ^ 

) 

referent 



( 






ELEMENT 



gi: section 
id: 4 



(referent nl) 

Returns the element nodes referenced by attribute-value-token nodes 
in nl. Elements are pointed by IDREF attributes, which are represented in the 
SGML property set by nodes of class at tribute -value -token. 

See Also: Section 4.8.4. 

match-element? 



(match-element? string snl) 

Returns #t if the gi of snl matches string, snl defaults to 
(current -node) . 

(match-element? pattern snl) 

Returns #t when snl matches pattern, a list of gis specifying a chain of 
parentship. gis can also be parameterized with attribute values, snl defaults to 
(current -node) . 
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Example 5-47. Match-element? 

(match- element? 

' (book chapter section (id 4) title) 

(node-list-first (children (ipreced (current-node) ) ) ) ) — >• #t 

The pattern looks for books containing sections with an ID of 4 containing titles. 
All title elements that match the condition will return #t. 

select-elements 

(select-elements nl pattern) 

Returns the members of nl that match pattern the same way as in match- 
element?. Pattern can be a single string. 

Example 5-48. Select-elements 

(select-elements (subgrove (grove-root (current-node) ) ) 

' (chapter section) ) — ^ 




See Also: match-element?. 

q-element 

(q-element pattern nl) 

Searches the subgroves rooted on nl nodes for elements matching pattern, as 
defined by the match-element? procedure, nl defaults to ( current -node ) . 

Example 5-49. Q-element 

(q-element (grove-root (current-node) ) ' (chapter section) ) — >■ 




See Also: match-element?. 

q-class 



(q-class symbol nl) 
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Searches the subgroves rooted on nl nodes for nodes of class symbol, nl de- 
faults to (current -node) . 

Example 5-50. Q-class 

(q-class 'attribute-assignment (grove-root ( current -node) ) ) — ^ 

1 

( 

q-sdata 

(q-sdata string nl) 

Searches the subgroves rooted on nl nodes for nodes of class sdata whose sys- 
data property value is string, nl defaults to (current -node) . 

See Also: Section 4.8.6. 

5.4.8. Auxiliary Parsing 

5.4.8.1. Word Searching 

This set of procedures allows the searching for words in the grove. They require the 
word feature. 

word-parse 



7 

ATTRIBUTE-ASSIGNMENT 



name: status 



(word-parse nl string) 

Builds an auxiliary grove for the nodes in nl. string is the ISO 639 language 
code of the language assumed for determining words. 

The propset for the auxiliary grove is datatok. As an auxiliary grove, it has 
the intrinsic property source. 

Table 5-1. Class tokenized-root in datatok propset 



property 


type 


subnodes 


strings 


node-list 


tokenized- string 
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Table 5-2. Class tokenized-string in datatok propset 



property 


type 


string 


String 



Each tokenized-string represents a word string in the data of nl. 

select-tokens 

(select-tokens nl string) 

Returns all tokenized-string nodes of the auxiliary grove nl that match string. 
This procedure is the one that searches for the words. 

Example 5-51. Select-tokens 

(select-tokens (word-parse ( current -node ) ) "S2") 

source 

A grove created by means of an auxiliary parsing is called an auxiliary grove. The 
grove analyzed to create the auxiliary grove is called the source grove. Each node 
in an auxiliary grove has a source intrinsic property of type urefnode that that 
points to those nodes in the source grove from which the node was derived. Thus, 
with nodes in the auxiliary grove the source procedure can be used. 

Example 5-52. Source 

(source (select-tokens (word-parse ( current -node ) ) "C1S2P1") — ^ 

( “ ) 

I C1S2P1 I 



S.4.8.2. Node Regular Expressions 

The procedures in this section require the regexp feature. 

Node regular expressions allow the definition of finite state machines for the search of 
nodes in node-lists by means of incontextual patterns. 

regexp-node 



(regexp -node proc) 



Defines a pattern that matches one node when proc applied to that node returns 
#t. It is the basic procedure for the definition of node regular expressions, proc 
is a boolean procedure that only accepts one node as parameter, regexp-node will 
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be applied always to a singleton node-list, and that singleton node-list will be the 
one passed to proc. 

Example 5-53. Regexp -node 

Pattern that matches those nodes that aren’t the last sibling between their siblings. 

(regexp-node (lambda (x) (not (node-list-empty? (ifollow x) ) ) ) ) 

Having some mechanism to define basic regular expressions, it is necessary to com- 
bine them into more complex ones. The procedures below offer several methods of 
combination, following the standard mechanisms of regular expressions. 

regexp-seq 

( regexp -seq regexp . . . ) 

Defines a pattern that matches the sequence of the argument patterns. It is equiva- 
lent to , in the common mathematical notation for regular expressions. 

Example 5-54. Regexp-seq 

An a element followed by a b element 

(regexp-seq 

(regexp-node (lambda (x) (match-element? "a" x) ) ) 

(regexp-node (lambda (x) (match-element? "b" x) ) ) ) 

regexp-or 

(regexp-or regexp . . .) 

Defines a pattern that matches one and only one of the argument patterns. It is 
equivalent to | in the common mathematical notation for regular expressions. 

Example 5-55. Regexp-or 

An a element or a b element. 

(regexp-or 

(regexp-node (lambda (x) (match-element? "a" x) ) ) 

(regexp-node (lambda (x) (match-element? "b" x) ) ) ) 

regexp-and 



(regexp-and regexp . . . ) 

Defines a pattern that matches all of the argument patterns. It is equivalent to & in 
the common mathematical notation for regular expressions. 
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Example 5-56. Regexp-and 

An a element that has some children. 

(regexp-and 

(regexp-node (lambda (x) (match-element? "a" x) ) ) 
(regexp-node (lambda (x) (f irst-child-gi x) ) ) ) 

regexp-rep 



(regexp -rep regexp) 

Defines a pattern that matches zero or more times the argument pattern. It is equiv- 
alent to * in the common mathematical notation for regular expressions. 

Example 5-57. Regexp- rep 

Several a elements in sequence, accepting there can be none. 

(regexp-rep 

(regexp-node (lambda (x) (match-element? "a" x) ) ) ) 

regexp-plus 



(regexp -plus regexp) 



Defines a pattern that matches one or more times the argument pattern. It is equiv- 
alent to + in the common mathematical notation for regular expressions. 

Example 5-58. Regexp-plus 

Several a elements in sequence, at least one. 

(regexp-plus 

(regexp-node (lambda (x) (match-element? "a" x) ) ) ) 

regexp-opt 



(regexp-opt regexp) 



Defines a pattern that matches zero or one times the argument pattern. It is equiv- 
alent to ? in the common mathematical notation for regular expressions. 

Example 5-59. Regexp-opt 

An optional a element 

(regexp-opt 

(regexp-node (lambda (x) (match-element? "a" x) ) ) ) 

regexp-range 

(regexp -range regexp k^) 

Defines a pattern that matches the argument pattern between times and 
times. It is equivalent to .. in the common mathematical notation for regular ex- 
pressions. 
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Example 5-60. Regexp-range 

An a element repeated between i and j times. 

( regexp - range 

(regexp-node (lambda (x) (match-element? "a" x) ) ) 
i 

j) 

The procedures above for the combination of regular expressions return regular expres- 
sions, too, that can be combined again, thus forming more complex regular expressions. 

Example 5-61. Complex Combined Regular Expression 

Try to guess the pattern of elements that the regular expression matches. The answer is 
after the code. 

(regexp-seq 

(regexp-node (lambda (x) (match-element? "a" x) ) ) 

(regexp-node (lambda (x) (match-element? "b" x) ) ) 

(regexp-or 

(regexp-node (lambda (x) (match-element? "c” x) ) ) 

(regexp-node (lambda (x) (match-element? "d" x) ) ) ) 

(regexp-plus 

(regexp-seq 

(regexp-opt 

(regexp-node (lambda (x) (match-element? "e" x) ) ) ) 

(regexp-node (lambda (x) (match-element? "f" x) ) ) ) ) ) 

Solution: a,b,(c|d),(e?,f)+ 

string->regexp 



( string->regexp string) 



Returns the regexp represented by string, string shall be an ISO 9945-2 
extended regular expression. A normal character in s tring matches a node with 
a char property whose value is that character. 

Regular expressions are evaluated relative to a node-list using one of the two procedures 
below. 

regexp-search-disjoint 



(regexp-search-disjoint nl regexp) 

Searches sublists in nl that match regexp ensuring the final results are disjoint, 
following the rule of accepting always the sublists that start before, and never 
searching inside sublists already accepted. 




Chapter 5. The Standard Document Query Language (SDQL) 



135 



Example 5-62. Regexp-search-disjoint 

Obtain all a elements in sequence that are children of b elements. 

(regexp-search-dis joint 

(children (q-element "b" {subgrove (grove-root)))) 
(regexp-plus 

(regexp-node (lambda (x) (match-element? "a" x) ) ) ) 

regexp-search 



(regexp -search nl regexp) 



Searches for all the sublists in nl that match regexp. The results may intersect, 
or be contained in one another. 

When a pattern in a node-list is being sought, a sublist searching process is executed. 
The general working is defined in the standard in an inductive way, describing the ef- 
fect of each combinator. Given the procedure (regexp- search x regexp) the 
method, in a graphical way, will be the next for each of the different kinds of combina- 
tor s. 

• (regexp-node proc) — > n 
n 

i-l 

X 



when (proc n) = #t 

• ( regexp- seq regexpl regexp2 . . . regexpn) — ^ nl n2 ... nn 
nl n2 nn 



X 



when for each i regexp, searches n. 

• (regexp-or regexpl regexp2 . . . regexpn) — ^ n 
n 



X 



when for some i, regexp, searches n 
• (regexp-and regexpl regexp2 . . . regexpn) — ^ n 

n 



X 
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when for all i, regexp, searches n 

• (regexp-rep regexp) empty-node-list 

nl n2 ... nn 

nl n2 nn 



X 



when for each i regexp searches n., accepting n=0 

• (regexp-plus regexp) empty-node-list 

nl n2 ... nn 



nl n2 nn 



X 



when for each i, regexp, searches n., with n>0 

• (regexp-opt regexp) — > empty-node- list 

^ n 



n 



X 



when regexp searches n, but n can be missing 
• (regexp-range regexp i j) — > nl n2 . . . nk 

nl n2 nk 



X 



when for each k regexp searches a, for i<=k<=j 

When the search procedures find a sub node-list that matches a pattern, they return an 
auxiliary grove that follows the propset regexp. 

Table 5-3. Class root in regexp propset 



property 


datatype 


subnodes 


* groups 


node-list 


group 



Table 5-4. Class group in regexp propset 



No properties. It only has the intrinsic properties, including source because it is 
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an auxiliary grove. 

Those auxiliary groves have one root node with a groups property. Inside this property, 
only group nodes are accepted. The source attribute of each group node contains one of 
the sublists that match the search pattern. There will be so many group nodes as sublists 
the patterns matches. 



5.5. Exercises 

The best way to understand the query language is to use it. Below several exercises 
are proposed and solved which need one or more SDQL procedures. The exercises 
proposed are not arbitrary, but will be used later in the book for transformation or style 
examples. Each exercise will include a statement of the problem, the usefulness of the 
query and a solution. The best way for the reader to learn is to try to solve the exercises 
before reading the solution. 

Example 5-63. First Child 

Problem. Write an expression to know whether an element is the first child of its parent. 

Usefulness. When processing lists of items, usually the second and subsequent ele- 
ments are separated from their predecessors with some sign, but the first has no pre- 
decessor, so no separation is needed. For example in a, b, c, before b and c (all the 
elements but the first) a comma and a space have been inserted. 

Answer. 

(first-sibling? node) 

Comment, first-sibling? works for elements with the same gi. Another option would 
be to use absolute-first-sibling?. 

Example 5-64. Position Between Children 

Problem. Write an expression that returns the number of an element between its sib- 
lings with the same gi. 

Usefulness. In a list, items may be numbered. 

Answer. 

(chi Id- number node) 

Example 5-65. Attribute Values 

Problem. Write an expression that returns the value of an attribute. 

Usefulness. Grammatical categories may be codified as attributes in some word ele- 
ment, and to make the category appear in the text, its value must be retrieved from the 
attribute. 

Answer. 

(attribute-string "attribute-name" node) 
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Example 5-66. Multiple Children 

Problem. Write an expression that evaluates whether an element is the only sibling 
with the same gi. 

Usefulness. When generating lists, items may be numbered only if there are more than 
one item. 

Answer. 

(and (first-sibling? node) (last-sibling? node)) 

Example 5-67. Flattening the Grove 

Problem. Write an expression that returns all the nodes of the grove in a node-list. 

Usefulness. It can be used to apply some processing in a uniform way to all nodes of 
the grove. 

Answer. 

(subgrove (grove-root (current-node) ) ) 

Example 5-68. Identifying the Root 

Problem. Write an expression that detects whether the current node is the root. 

Usefulness. In a uniform default processing, usually the root is handled differently to 
the other nodes. 

Answer. 

(not (origin-to-subnode-rel (current-node) ) ) 

Example 5-69. Obtaining Elements 

Problem. Write an expression that returns all the figref elements. 

Usefulness, to process all elements with same gi in the same way. 

Answer. 

(q-element 'figref (grove-root (current-node))) 

Example 5-70. Obtaining Parts of the Document 

Problem. Write an expression that returns all the figref elements in the first chapter. 
Usefulness, to process elements depending on their context. 

Answer. 

(q-element 
' figref 

(node-list-first (q-element 
' chapter 

(grove-root (current-node) ) ) ) ) 
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Example 5-71. Several Elements 

Problem. Write an expression to obtain all number attributes of A and B elements that 
are descendants of the current node. 

Usefulness, to see how to process more than one element at a time. 

Answer. 

(attribute "number" (node-list-union (q-element 'A) (q-element 'B))) 

Example 5-72. Hyperlink Traversing 

Problem. Write an expression to obtain all nodes referenced by the RID attribute (of 
type IDREF) of any figref element. 

Usefulness. To obtain elements referenced from other elements. 

Answer. 

(referent (attribute (q-element 

' figref 

(grove-root (current-node) ) ) 

"RID" )) 

Example 5-73. Current Node Testing 

Problem. Write an expression that tests whether the current node is a fig element. 
Usefulness. In general, it is interesting to know which element is being processed. 

Answer. 

(match-element? 'fig). 

Comment. Another possibility would be (string=? (gi) "fig"). 

Example 5-74. Semantic Tests 

Problem. Write an expression to locate those nodes that, being referenced by RID 
attribute from a figref element, are not figures. 

Usefulness. To locate semantic errors, like pointers to images that are not pointing to 
images. These are errors that SGML cannot detect because they are beyond its scope. 

Answer. 

(select-each x 
(referent 

(attribute (q-element 'figref) "RID")) 

(not (match-element? 'fig x) ) ) 

Example 5-75. Separating Elements 

Problem. Write an expression to obtain all subelements of sections that aren’t sections. 

Usefulness, when a concrete processing is to be performed for sections, like generating 
them in different files, but the processing of their contents will not be different from 
one section to the other. 



Answer. 
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(node-list-dif f erence 

(subgrove (q-element 'section)) 

(q-element 'section)) 

Example 5-76. Testing Emptiness of an Element 

Problem. Write an expression that detects whether a thematic-index element has chil- 
dren or not. 

Usefulness. To generate automatically a thematic-index, the program will behave dif- 
ferent when the index has already entries or not. 

Answer . 

(node-list-empty? (children (q-element 

' thematic -index 
(current-root) ) ) ) 



Example 5-77. Recopilating Elements with Specified Attributes 

Problem. Write an expression that locates all the photo elements that have some value 
specified in the caption attribute. 

Usefulness. To generate a thematic index of all photographs that have some caption. 

Answer. 

(select-each photo 
(q-element 'photo) 

(attribute-string "caption" photo) ) 

Example 5-78. Hyperlinks together with Anchors 

Problem. Write an expression that detects whether some remission is placed next to 
the entry it references. 

Usefulness, when generating a dictionary remissions that are next to the destination 
will be suppressed. 

Answer. 

(node-list-contains? 

(node- list-union 

(ipreced (current-node)) 

(ifollow (current-node))) 

(referent (attribute (current-node) "entry"))) 
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6.1. Introduction 

The transformation process is used to transform a source grove into a result grove under 
control of a transformation specification. The result grove of this process may be used 
as input to a subsequent formatting process. This allows, on the one hand, to reduce 
the quantity of information to mark up as it can be automatically generated by the 
transformation process, and on the other hand, to simplify the formatting process by 
prior arrangement of the structure. 

In the transformation process, the user identifies portions of the grove that can be at- 
tached or transformed. These portions are identified using procedures defined in the 
query language. 

All the operations executed in the transformation process are independent of the subse- 
quent formatting process. The operations that can be performed include: 

• Combination of structures: The SGML structures can be reordered and regrouped to 
create totally new structures. For example footers that follow their references, as the 
DTD defines, can be kept together to place the footers as end notes at the end of each 
chapter, in preparation for when the document will be formatted. 

• Creation of new elements with specifiable relations with other elements: New struc- 
tures or attributes can be created. For example, a thematic index can be created with 
all index terms that are marked in the content of the document. 

• Association of new descriptions with particular sequences of content: A sequence 
of elements in the document can fire the association of different formatting charac- 
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teristics. For example, a paragraph following a warning could need a presentation 
different to other paragraphs. 

• Association of new descriptions with particular components of content: An associa- 
tion can be used to assign a special format to particular strings of text that couldn’t 
be specially marked in the source document. For example, the string "ISO" could be 
substituted by the ISO logo. 

DSSSL permits the formatting information to be associated with, and depend on, any 
combination of the above options. The content, as well as the structure, of the SGML 
document can be modified. 

The transformation language can be used to help the formatting process as has been 
pointed out in the previous examples, or it can be used to enhance or modify the 
documents created. For example, updating documents to comply with a DTD that has 
changed over time, or to transform documents to a public or tailored DTD. 

The importance and the use of the transformation language will vary depending on 
the SGML application, the capabilities of the formatter and the implementation. Many 
formatting applications will need no transformation of any kind at all. 

6.2. Processing Model Overview 

The transformation process is composed of a sequence of processes. 

Figure 6-1. The transformation process 




a. Grove building processor 

When an SGML document is to be processed, the text format in which it is rep- 
resented is not an adequate model for an efficient processing, as it is a sequential 
representation. The DSSSL standard defines an abstract data model, called grove, 
which supports all the different possible data structures present in an SGML docu- 
ment. The grove building processor is the process in charge of analyzing the SGML 
document and constructing a grove that represents the document. 

b. Transformer 
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Taking as input the grove constructed in the previous process and the transfor- 
mation specification, the transformer applies the transformations specified in the 
specification. The transformation specification is a collection of associations, that 
specify the transformation of objects in the source grove into objects in the result 
grove. The transformer can operate on a M:N relation, taking several documents 
as input, and generating several documents as output. 

c. SGML Generator 

The transformer creates a grove that must be converted back into SGML format 
for interchange, validation, and input to the formatting process. 



6.3. The Transformer 

The input to the transformation process includes the SGML document, as it has been 
created in the groves creation process, and the transformation specification. The grove 
for the transformation process is shown and explained in Figure 4-3. 

The transformation specification consists of a collection of associations, each speci- 
fying the transformation of objects in the source document into objects in the result 
grove. It is key for this transformation process that not only can each object be attached 
to an explicit position in the result grove, but also to a relative position using the result 
of transforming another source object as a reference point. 

The output of the transformation process is a result grove. The process can operate on 
several SGML documents as input, and in the same way they can be transformed into 
many SGML documents. 

6.4. The Transformation Language 

The transformation process requires a unique grove as input, that is transformed as the 
associations specify. An association can also cause the transformation of other groves. 
The grove being transformed is called the current grove. 

The transformation process is specified by means of a collection of associations. 



=> 



(=> (query- express ion) 

(transformation-expression) 
(priority-expression) ) 



An association is composed of three elements. 

• A query expression, that returns a node-list; an association is potentially appli- 
cable to any node in the node-list. All the nodes should be in the current grove 
or in an auxiliary grove whose source is the current grove (See Section 5.4.8). 
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• A transform expression that is evaluated for each of the potential nodes. The 
return value describes the node or nodes in the result grove corresponding to 
the selected node in the source grove. 

• A priority expression that affects whether the association is actually applied to 
the node for which it is potentially applicable. Only the association with the 
highest priority will apply to a node. The priority expression must evaluate to 
an integer, and the larger the number, the greater the priority. 

6.5. Transformation Expressions 

Each transformation expression must return an object of type create- spec, transform- 
grove-spec, or a (possibly empty) list of both. An object of type transform-grove-spec 
represents a grove that must be transformed in addition to the current grove. Each 
create- spec object describes a subgrove that must be created in a specific place in the 
result grove. The subgrove may consist either of a single node or of multiple nodes 
composing a subgrove rooted at a single node. The place where the subgrove shall be 
created can be specified as the root of a result grove (create-root) or relative to another 
node in the result grove (create-sub, create-preced, create-follow). 

When a result node is created from a source node, a connection is created and given a 
name. These connections are called arrows. The starting point of an arrow is called the 
transformation origin. Arrow labels distinguish between the different transformations 
that have been applied to the node. 

6.5.1 . Create-spec 

As has been explained, there are two kinds of objects to specify transformations. The 
first is the create-spec. In this type of procedure subgroves are created in the result 
grove from nodes in the source grove. These result subgroves are defined by means of 
the subgrove-spec procedure. 



6.5.1. 1. Subgrove-spec 

subgrove-spec 



(subgrove- spec # ! key node: subgrove: class: add: null: 
remove: children: sub: label: sort-children:) 



This procedure is used to define the portion of the grove that shall be inserted in 
the result grove. All the nodes defined must have a common root in a single node, 
and this root is the node that will be inserted in the result grove. This portion can 
be from one single node to a whole grove. There are three ways to insert a node: 
to copy an existing node, to copy a whole subgrove, or to create the node to be 
inserted. 

• node: specifies the insertion of a copy of the single source node parameter. 
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Example 6-1. node: 

node: (current-node) 

• subgrove; specifies the insertion of a copy of the source subgrove rooted in the 
single source node parameter. If a new grove is created that follows a different 
DTD, it is specified using this keyword and the procedure sgml-parse-prolog. 

Example 6-2. subgrove: 

subgrove; (sgml-parse-prolog "new.dtd") 

• class: specifies the creation of a new node whose class will be the symbol pa- 
rameter. This node won’t be a copy of a source node. 

Example 6-3. class: 

class: 'element 

One and only one of the three keywords above may be specified in a single 
subgrove-spec. The rest of keywords modify the nodes being inserted or created, 
and depend on one of the three main keywords above. With add: and node:, the 
keywords null:, remove:, sub: and children: are used. The keyword label: is used 
with all main keywords. 

• add: specifies non intrinsic non nodal properties with non null values to be 
added to the result node. The properties are specified by an association list of 
property names and property values. When this keyword is used together with 
node: it replaces the values of the specified properties of the source node. 

Example 6-4. add: 

add; ' ( (gi item) (name entry) ) 

• null: specifies additional non intrinsic properties of the node that should have 
a null value. If it is used together with node: it replaces the values of the node. 
The properties are specified with a list of property names. 

Example 6-5. null: 

null: '(attributes) 

• remove: specifies that the node to be created shouldn’t have certain non intrinsic 
properties. 

Example 6-6. remove: 

remove: ' (attributes) 

• sub: specifies subnodes of the result node, by means of an association list of 
property names and sub grove-spec. 
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Example 6-7. sub: 

sub: ' ( (attributes 

(subgrove- spec 

class: 'attribute-assignment 
add: ' ( (name entry) 

(value 3 ) ) ) ) ) 

• children: specifies children of the result node. This can also be done by means 
of a combination of the sub: keyword and the property name children, but the 
standard recommends using this keyword. The parameter is a list of subgrove- 
specs. 

Example 6-8. children: 

children: ' ( (subgrove- spec 

node: (current-node))) 

• label: specifies a name to be given to the arrow that links the source node to 
the root node of the result subgrove that will be created. The parameter is a 
symbol. The usefulness of labels will be made clear by the explanation of the 
create-spec procedures in Section 6.5. 1.2. The use of label: only makes sense 
when the procedures create-sub, create-preced or create-follow are to be used. 

Example 6-9. label: 

label: 1 

• sort-children: provides a procedure that defines an ordering relation on the chil- 
dren of the root node of the result subgrove. The method that must be provided 
as parameter must accept two nodes as parameters and return #t when the first 
node is before the second node. In execution, the method defined will receive 
the origins of the nodes to compare.. 

Example 6-10. sort-children: 

sort-children: (lambda (x y) (string>? (gi x) (gi y) ) ) 

subgrove-spec is the procedure responsible for declaring the nodes to be inserted in 
the result grove. When specifying the node’s properties, the definitions of the prop- 
erty set must be taken into account. Derived properties shall not be included, as they 
are automatically generated at the end by the SGML document generator. Thus, for 
example, if an element with an ID is added, it will be automatically linked to the list 
of elements with unique IDs; the programmer doesn’t have to explicitly do it within 
the program. Optional properties may also be left unspecified, as their presence in the 
node is not required. Nodes of class mayadd may also be left unspecified, as the SGML 
generator will generate them if they are not specified. It is better for the programmer 
to concentrate on required properties. Properties with when conditions in the property 
set are the only ones that accept a null value in case the condition is not met. For more 
explanations on these aspects see Section 4.7 and Section 6.5.6. 
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6.5.1 .2. Create-spec Procedures 

Subgroves defined by means of subgrove-spec must be inserted at concrete points of 
the result grove. This is performed by the four procedures of type create-spec. 

create-root 



(create-root obj sg) 

Every grove has a single root. The procedure create-root is in charge of creating 
the root of the result grove, obj will be the identifier of the subgrove and sg 
is a procedure of type subgrove-spec. When a transformation process generates 
several result groves, each result grove will correspond to a different create-root 
call. Arrows generated by labels will help to distinguish the result groves from 
each other. 

Example 6-11. create-root 

(create-root 

#f 

(subgrove-spec 

node: (current-node))) 

create-sub 

(create-sub snl sg #!key property: label: 
result-path: optional: unique:) 

Specifies the creation of a node as a member of the property indicated by 
property: . 

• property: specifies the property that will accept the subnode. If nothing is 
specified it defaults to the children property. 

Example 6-12. property: 



property: "attributes" 

• label: specifies the arrow that must be followed from the origin to place the 
node that is being inserted. Depending on the creation method, the node will be 
placed as subnode {create-sub), after (create-follow) or before (create-preced) 
relative to the end of the arrow. Arrows are created in the subgrove-spec proce- 
dure by means of keyword label:. By default its value is #f. 

Example 6-13. arrow creation with label: in subgrove-spec 

An arrow starting in (current -node) is labeled arrow-name -symbol 
in subgrove-spec. 

(create-sub 

(current-node) 

( subgrove- spec 

label : ' arrow-name -symbol 

. . .) ) 
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Example 6-14. arrow triggering with label: in create-spec 

An anow arrow-name -symbol starting in (current -node) is triggered 
from create-sub. The node to be inserted as subnode will be placed in the node 
that is at the end of the arrow. 

(create-sub 

(current -node) 

(subgrove- spec . . . ) 
label: ' arrow-name- symbol) 

See Example 6-24 for an example of the use of this triggering mechanism. 

• result-path: this keyword allows the definition of a procedure whose objective 
is to define the creation origin. By default the identity procedure is used, but 
any other procedure can be specified that returns a result-node-list composed of 
a single node at some moment in the construction of the result grove. Section 
6.5.1 .3 explains the DSSSL procedures capable of operating on result node lists; 
the only ones that may be used in the context of the procedure specified in 
result-path: . 

• optional: is a boolean specifying whether the arrow may be omitted. By default 
its value is #f, meaning that the arrow may not be omitted. 

• unique: if not false, the origin of the subgrove must be unique and cannot be 
shared with another node. 

Example 6-15. create-sub 

(create-sub 

(origin (current-node) ) 

( subgrove- spec 

node: ( current -node ) ) 

property: "attributes" 
label: 1) 

create-preced 



(create-preced snl sg #!key label: result-path: 
optional: unique:) 

Specifies the creation of a subgrove that will be created as the preceding sibling 

of its origin. The keywords have the same meaning as in create-sub. 

Example 6-16. create-follow 

In this example, the current node is preceded by a copy of itself. 

(create-preced 
(current -node) 

(subrove-spec 

node: (current-node))) 

create-follow 

(create-follow snl sg # ! key label: result-path; 
optional: unique:) 
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Specifies the creation of a subgrove that will be created as the following sibling of 
its origin. The keywords have the same meaning as in create- sub. 

Example 6-17. create-follow 

In this example, the current node will be followed by a copy of itself. 

(create-follow 
(current -node) 

(subrove- spec 
node: (current-node))) 



create-spec? 



(create-spec? ob j ) 



This procedure returns #t when obj is an object of type create-spec. 

Example 6-18. create-spec? 

(create-spec? 

(create-root 

#f 

( subgrove-spec 

node: (current-node)))) 

->#t 

All those procedures specify the creation of nodes in the result grove, but the actual 
creation will only take place inside a transformation expression. 



6.5.1. 3. Result-node-list Query Language Procedures 

The following procedures can be used for expressions querying the result grove. They 
are only to be used by the procedure specified in result-path: in create-spec procedures. 
Several have the same functionality as in SDQL, Chapter 5. 

node-list-union 

See: node-list-union in Chapter 5. 

node-list-intersection 

See: node-list-intersection in Chapter 5. 

children 

See: children in Chapter 5. 

attributes 

See: attributes in Chapter 5. 

preced 

See: preced in Chapter 5. 
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follow 

See: follow in Chapter 5. 

parent 

See: parent in Chapter 5. 

ancestors 

See: ancestors in Chapter 5. 

descendants 

See: descendants in Chapter 5. 

origin 

See: origin in Chapter 5. 

select-by-class 

See: select-by-class in Chapter 5. 

select-by-property 

See: select-by-property in Chapter 5. 

select-by-null-property 

See: select-by-null-property in Chapter 5. 

select-by-missing-property 

See: select-by-missing-property in Chapter 5. 

select-by-relation 

(select-by-relation rnl i proc) 

Returns a result-node-list with those nodes of rnl that applied to procedure proc 
return a result-node-list with i or more nodes. 

Example 6-19. select-by-relation 

(lambda (x) 

(select-by-relation 
(children x) 

1 

(lambda (y) 

(select -elements 
(descendants y) 

"para" ) ) ) ) 

select-by-attribute-token 

(select-by-attribute-token rnl string^ string^) 

Returns a result-node-list containing those nodes in rnl that have an attribute 
named string^ and that have an attribute with a child of class attribute- value- 
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token with a token property equal to string^ after any applicable string normal- 
ization. 

6.5.2. Transform-grove-spec 

The other type of transformation expression object is the transform- grove- spec. An 
object of type transform-grove- spec represents a grove to be transformed in addition to 
the current grove. The procedures below operate on this type of object. 

transform-grove-spec? 



( transform-grove-spec? ob j ) 

Returns #t when obj is a transform-grove-spec. 

transform-grove 



(transform- grove grove-root obj . . . ) 

This procedure creates a new grove from the grove-root node by adding a 
transform- args property to the grove root whose value is a list containing obj 
. . . , and returns an object of type transform-grove-spec specifying the transfor- 
mation of that new grove. Use of this procedure requires the multi-source feature. 

select-grove 



(select-grove nl obj) 



Returns a node-list containing those members of nl whose grove root has a 
transform-args property that contains a member equal to obj. 

Transform-grove-specs specify other groves that shall be processed and transformed 
using the same associations present in the transformation specification. Unfortunately 
the text of the standard is so brief in its explanation of these objects that not much more 
can be said about them. Nor can any example be offered. These objects allow the input 
of multiple input SGML documents. 



6.5.3. Transformation Patterns 

In this section different associations are explained for basic transformations. The use 
of the transformation language is relatively easy: it is composed of a small number of 
procedures, and its explanation is quite simple. Any complication comes from the com- 
plexity of the underlying data model that guides the structure of a SGML document. 
The transformation language must be used coherently with this data model. In this sec- 
tion, along with an explanation of the associations, the manner in which the SGML 
propset supports the structure will also be explained. 

In this section the examples gradually increase in complexity, but are limited to basic 
patterns. The examples are given in the form of procedures with parameters. It is un- 
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clear whether the transformer can support this kind of definition, as it expects that the 
upper level object is the association which is managed in a way similar to the logical 
rules in the prolog. The format chosen for these examples is only a way to show the 
variables that affect the process being exemplified. 

6.5.3.1 . Neutral Transformation 

This means no transformation at all. Or better said, transforming by copying everything, 
and leaving everything in the same position. This is the most simple transformation 
possible, as it means taking all the nodes of the grove and copying them to the result 
grove. 

To obtain all the nodes of the grove, the subgrove procedure us used. 

(subgrove (grove -root) ) 

In the grove two kinds of nodes can be distinguished, the root and the rest of nodes. 
The root is distinguished because it has no origin. Origin is an intrinsic property that 
all nodes except the root have. 

(origin (current-node) ) 

The root node must be created with the create-root procedure. 

(create-root 

#f 

. . . ) 



On the other hand, the rest of nodes do have an origin, and must be processed with the 
create-suh procedure, keeping the same origin as in the source grove. The nodes will 
be processed in a uniform way, and they will have to be placed in the same property 
where the source is placed. If the property: keyword in the create- sub procedure is 
not specified, children is understood by default. But not every node is placed in the 
children property. For example, attributes are placed in the attributes property of the 
element node. The property where a node is placed in its parent node is obtained using 
the origin-to-subnode-rel procedure. 

(create-sub 

(origin (current-node) ) 

property: (origin-to-subnode-rel (current-node) ) ) 

All nodes are copied literally. 

( subgrove -spec 

node: (current-node)) 



Thus the complete association is as shown below. 

(=> (subgrove (grove-root)) 

(if (origin (current-node)) 
(create-sub 
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(origin (current-node) ) 

( subgrove- spec 

node: ( current -node ) ) 

property: (origin-to-subnode-rel (current -node) ) ) 

(create-root 
#f 

( subgrove-spec 

node : (current-node) ) ) ) ) 



In this transformation there are some parts that can be isolated, as they are useful in 
general applications, and are used in later exercises. 

(define (copy-of -current -node) 

( subgrove- spec 

node: (current -node) ) ) 

(define (copy-current -node -re lative-to-origin) 

(create-sub 

(origin (current-node) ) 

(copy-of -current -node) 

property: (origin-to-subnode-rel (current -node) ) ) 



6.S.3.2. To Insert an Empty Element into an Empty Element 

This is the most simple case of insertion of a new element. 

Subelements are represented as element nodes inside the content attribute of another 
element node. 

Figure 6-2, Insertion of a new empty element into another empty element 



Before: 

element 



id: element -id 
content: (empty-node-list) 



After: 



element 


content 


element 


id: element -id 


^ 


gi: new-element-name 



The new node to be created is of class element, and its name is new-element-name. 



( subgrove -spec 
class: 'element 

add: ' ( (gi , new-element-name) ) ) 
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This element will be inserted in the content property of a previously existing element. 
There are two possibilities: the existing element can have subelements or not. In this 
association the supposition is that there are no previously existing subelements or that 
the element is empty. In following associations the range will be increasingly completed 
until a complex example will be given that does not make such a supposition. In this 
association, as the element is supposed to be empty, if the element were not empty its 
content would simply disappear after the transformation takes place. No property must 
be specified in create-sub, because content is the children property of nodes of class 
element. 

(create-sub 

(current-node) 

. . .) 

All that is left is to choose the element that will be the parent. For example, the ID of 
the element can be used to find it. 

(element-with-id element-id (grove-root) ) 

Joining all the portions, the complete association will finally be as below. 

(define (add-empty-elem-into-empty-elem element-id new- element -name) 

(=> (element-with-id element-id (grove-root) ) 

(create-sub 

( current -node ) 

( subgrove - spec 
class: 'element 

add: ' ( (gi , new- element -name) ))) ) 



6.5.3.S. To Insert an Empty Element into a non Empty 
Element 

In this example the parent element will not be empty, and the element to be inserted will 
have siblings. It means, the parent element already has children, and the new element 
will have to be inserted in an ordered position relative to its siblings. 

Figure 6-3. Insertion of an empty element between siblings 



Before: 






element 


origin 




element 


id: parent -name 




id; sibling-id 



After: 
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element 




origin 

origin 


gi: new-element -name 


element 


element 




id: parent -name 


oHgin 


id: sibling-id 






element 






gi; new-element -name 



The new element to be inserted is an empty element. 

( subgrove -spec 
class: 'element 

add: ' ( (gi , element -name) ) ) 

If there are previously existing siblings, the new element has basically two positions 
where it can be placed: before a sibling or after a sibling. The position will be specified 
by a parameter. If the element has to be inserted before its sibling, the value ’’before" 
will be given. If the element has to be placed after some sibling, the value "after" will 
be given. 

(cond 

( (string=? "before" position) ...) 

( (string=? "after" position) ...)) 

If the element is to be inserted before, it will be done by means of the create-preced 
procedure, using as origin for the new element its sibling. 

(create-preced 
( current -node ) 

- . .) 

If the element is to be inserted after, it will be done by means of the create-follow 
procedure, using as origin for the new element its sibling. 

(create-follow 

(current-node) 

. . .) 



The sibling relative to which the new element will be inserted will be located using its 
identifier. 

(element-with-id sibling-id (grove-root) ) 

Thus, the complete association is as below. 

(define (add-elem-relat-to-sibling sibling-id position element-name) 
(let ( (new-element (subgrove- spec 
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class: 'element 

add: ' ( (gi , element-name) ))) ) 

(=> (element-with-id sibling-id (grove-root) ) 

(cond 

( (strings? "before" position) (create-preced 

( current -node ) 
new- element) ) 

( (string=? "after" position) (create-follow 

( current-node ) 
new-element ) ))))) 



6.S.3.4. To Insert an Intermediate Element 

This is the most complex case of the insertion of an element. The idea is to introduce 
a new element in a position, that will become the parent element of the elements that 
were previously in this position. 

Figure 6-4. Inclusion of an intermediate element 




In this case a new element will be inserted each time child-element- name appears. 

(q-element chi Id- element -name (grove-root) ) 

The new element is placed as child of the parent that previously contained child- 
element-name. Thus the origin of child-element-name is used as the origin of the new 
element . 

(create-sub 

(origin (current-node) ) 

. . . ) 



The new element will adopt the child element, copying the whole subgrove rooted on 
chi Id-element -name by means of the children : keyword of subgrove-spec. 



(subgrove- spec 
class: 'element 

add: ' ( (gi , new- element -name) ) 

children: (list ( subgrove- spec subgrove: (current-node)))) 
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The transformation is finally as shown below. 

(define (insert-new-parent new- element -name chi Id- element -name) 
(=> (q-element chi Id- element -name (grove-root) ) 

(create-sub 

(origin (current-node) ) 

(subgrove- spec 
class: 'element 
add: ' ( (gi , new- element -name) ) 
children : (list (subgrove- spec 

subgrove : (current-node) )))))) 



6.5.3.S. To Delete an Empty Element 

This transformation is very simple. Given that the element doesn’t contain any other 
elements, all that is required is to not insert the node in the result grove. Given an 
element, an empty list will be returned as a result of the transformation. 

(define (delete-empty-element element-name) 

(=> (q-element element-name (grove-root) ) 

(empty- list) ) ) 



6.5.3.6. To Add an Attribute 

As defined by the SGML propset, an attribute is represented by a node of class element 
containing, in the attributes property, a node of class attribute-assignment, that contains 
the value in its value attribute. If the attribute has textual content, it is structured with 
nodes of class data-char, one for each character, and if it is an IDREF attribute it is 
structured with a node of class attribute-value-token with an attribute referent, that 
points to a node of class element. In this example, the attribute will be a text one with 
only one character. 

Figure 6-5. Inclusion of a new attribute in an element 

Before: 

element 



gi: element-name 



After: 



element 




attribute-assignment 


vaLufi. ^ 


data-char 


gi: element-name 




name: attribute-name 




char: c 



It is possible that the element to which the attribute is to be added may already contain 
other attributes. Given an element, it can be determined if it has attributes by obtaining 
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the list of attributes, using the attributes procedure, and checking if it is empty with the 
node-list-empty? procedure. 

(node-list-empty? (attributes)) 

The string attribute will be included in all occurrences of an element whose name is 
element-name. 

(q-element element-name (grove-root) ) 



The attribute to be added is defined with the subgrove-spec procedure. The definition 
will include the attribute-assignment node and the data-char node. A single data-char 
will be created in the transformation for a single character. In a complete case, a list of 
data-char nodes should be created if the value is a string. 

( subgrove - spec 

class: 'attribute-assignment 
add: ' ( (name , attribute-name) ) 

children: (list (subgrove -spec 

class: 'data-char 

add: '((char , attribute-value-char )))) ) 



If the element to which the attribute is to be added doesn’t already have any attributes, 
all that is required is to put the new nodes in the attributes property. 



(create-sub 

(current-node) 

property: 'attributes) 



If, on the contrary, the element already has attributes, the new attribute will have to be 
placed in some position of the list of attributes. For example, it can be placed as the 
first node of the list by means of the procedure create-preced, and using as origin the 
first attribute of the element. 

(create-preced 

(node-list-first (attributes) ) 

. . .) 

Thus, the complete association is as below. 

(define (add-attrib element-name attribute-name attribute-value-char) 
(let ( (new-attribute ( subgrove -spec 

class: 'attribute-assignment 
add: ' ( (name , attribute-name) ) 

children : 

(subgrove -spec 

class: 'data-char 

add: ' ( (char , attribute-value-char ) ) ) ) ) ) 

(=> (q-element element-name (grove-root) ) 

(if (node-list-empty? (attributes) ) 

(create-sub 

( current-node ) 
new-attribute 
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property: 'attributes) 

( Great e-preced 

(node-list-f irst (attributes) ) 
new-attribute) ) ) ) ) 



6.5.S.7. To Modify the Value of an Attribute 

The value of an attribute is placed in the value attribute of the nodes of class attribute- 
assignment. The value can be of two kinds, textual or reference. Text values are codified 
with data-char nodes. References are codified with attribute-value-token nodes whose 
referent property points to the element node whose ID matches the IDREF. 

Figure 6-6. Modification of an attribute value 



element 




attribute-assignment 


valuf^ 


data-char 


gi: element-name 


attribute!^ 


name: attribute-name 




char: attribute-'/alue-char 



data-char nodes are final nodes that never contain subnodes. For this reason, the as- 
sociation needs to suppress the previous data-char nodes representing the old value 
of the attribute, and replace them for new data-char nodes with the new value of 
the attribute without caring for possible subnodes. It will result in two associations, one 
for suppressing old data-char nodes, another for adding new data-char nodes. 

The data-char nodes may be obtained from the containing elements with a pattern. 



(selec -by- class 



{subgrove (attribute attribute-name 

(q- element element -name 

(grove-root) ) ) ) 



' data-char) 



The old nodes shall be suppressed. An association can return an empty list what means 
a deletion of the selected node. 



(=> ... 

(empty-list) ) ) 

In the attributes of the specified elements the values must be inserted. 

(attribute attribute-name (q-element element-name (grove-root) ) ) 

For the new nodes represeting the new value, data-char nodes shall be inserted. 

( subgrove -spec 

class: 'data-char 

add: ' ( (char , attribute-value-char) ) ) 

The new nodes shall be inserted as attribute values in the specified element, value is the 
children property of at tribute -assignment nodes, and as such, it is the default 
property where the nodes will be inserted. 
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(create-sub 

. . •) 



Thus, the associations will be the ones below. 



(define (modify-attribute elem-name att-name att-val) 
(=> (selec-by-class 

(subgrove (attribute att-name 

(q-element elem-name 

(grove-root) ) ) ) 



' data-char) 

(empty-node- list) ) 

(=> (attribute att-name 

(q-element elem-name (grove-root) ) ) 

(create-sub 

( subgrove - spec 

class: 'data-char 

add: ' ( (char , att-val) ) ) ) 



6.S.3.8. To Delete an Attribute from an Element 

To delete an attribute from an element, all that is required is to not insert it in the result 
grove, while the rest of attributes will indeed be copied. 

Figure 6-7. Suppression of an attribute 



Before: 






element 




attribute-assigment 


gi: element-name 


attributes^ ^ 


name: attribute-name 



^fter; 

element 



gi: element -name 



The deletion will be performed in the whole document for those attributes whose name 
is attribute-name and whose value is attribute-value that pertain to an element called 
element-name. 

(map 

(lambda (x) (attribute attribute-name x) ) 

(q-element 

'(/element-name (, attribute-name , attribute-value) ) 

(grove-root) ) ) 

For the chosen attributes, the transformation is to not insert them into the result grove. 
It has to be remembered that an association can return an empty list. Although the stan- 
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dard does not explain the semantics of such empty list as return value of an association, 
it can be supposed it means a deletion of the selected node. 

(empty-list) 

Thus the complete association is as follows. 

(define (delete-attribute element-name attribute-name attribute-value) 
(=> (map 

(lambda (x) (attribute attribute-name x) ) 

(q-element 

'(/ element -name (, attribute -name , attribute-value) ) 
(grove-root) ) ) 

(empty-list) ) 



6.S.3.9. To Delete a non Empty Element 

This transformation is given as the last basic example because it is more complex than 
the other ones, as it causes the definition of several associations. 

To delete a non empty element can mean to delete its content as a whole, which is 
equivalent to the transformation in Section 6.5. 3. 5. But there is another way to design 
this transformation: to maintain the content of the element in the place where the ele- 
ment was placed. It could be understood as flattening or ungrouping the content of an 
element. 

Figure 6-8. Suppression of an intermediate element 




It will be first necessary to delete the element by means of the transformation offered 
in Section 6.5. 3. 5. 
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(=> (q-element element-name-to-delete (grove-root) ) 
(empty-list) ) ) 



But, in addition, the content of the element has to be placed where the element was 
placed before the deletion. The content of an element is obtained with the children 
procedure applied to the element node. 

(children (q-element element-name-to-delete (grove-root) ) ) 

The processing will be different if the child is the first sibling or one of the next siblings. 

( first -sibling?) 



The first child will be placed taking the position of its parent, and adopting for itself 
the origin its parent had. 

(create-sub 

(origin (parent (current-node) ) ) 

. . . ) 

If the child is not the first, it will only have to be placed next to its precedent sibling. 

(create- follow 

(ipreced (current-node) ) 

. . . ) 

The children will be copied intact, along with their subgroves. 

( subgrove- spec 

subgrove: (current-node)) 

Thus the transformation is as defined below. 

(define (suppress-element-keeping-content element-name-to-delete) 

(=> (q-element element-name-to-delete (grove-root) ) 

(empty-list) ) 

(=> (children (q-element element-name-to-delete (grove-root) ) ) 

(if (first-sibling?) 

(create-sub 

(origin (parent (current-node) ) ) 

( subgrove - spec 

subgrove : (current-node) ) ) 

(create- follow 

(ipreced (current-node)) 

( subgrove - spec 

subgrove : (current-node) ) ) ) ) ) 



6.5.3.10. To Specify of a String 

In all the exercises above textual values have been inserted as isolated characters. But 
text is usually written in big chunks forming sentences and paragraphs. In order to insert 
a string into a grove, the characters composing the strings must be put into data-char 
nodes. The procedure offered in this section performs this task. 
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For each character in the string, a node of class data-char has to be inserted. The 
char property of the data-char node will be assigned the corresponding character in 
the string. 

( subgrove -spec 

class: 'data-char 
add: ' ( (char , ch) ) ) 

The data-char creation must be performed for all characters in the string. 

(map . . . ) 

To apply the process to a string, it must first be converted into a list of characters. 
(string->list s) 

Then the specification will be as below. 

(define ( string->subgrove-spec-list s) 

(map : apply the lambda expression to the list 

( 1 ambda ( ch ) ;for each character 

( subgrove -spec ;a subgrove is specified 

class: 'data-char ; of data-char class 

add: '((char, ch) ) ) ) ; adding the character into char property 

(string ->list s))) ; convert the string into a list of characters 



6.5.4. Explaining Exercises 

Better than entering into a theoretical explanation of the transformation procedures, the 
next exercises will be used to show the kind of processing that can be performed with 
associations, and at the same time, it will serve to introduce and explain their use and 
combination. Many of the query expressions that will be used in the associations have 
been already used in the practical exercises at the end of the SDQL chapter. Chapter 5, 
so they should be familiar. 

Example 6-20. Restriction check 

To continue with simple exercises, we will see how the transformation language can be 
used to check semantics that is not possible to include in SGML. The ID/IDREF pair 
has a restriction that every value in an IDREF attribute must appear inside some ID at- 
tribute value. But this doesn’t limit which element’s ID is acceptable. There can be addi- 
tional semantic restrictions introduced by the document type, for which SGML doesn’t 
offer a specification mechanism. It is then necessary to perform the test with a pro- 
gram afterwards. The transformation below checks that every IDREF of titleref 
references an ID of some title. 

(=> (select-each x ; choose all nodes 
; pointed by the IDREF of titleref 

(referent (attribute (q-element 'titleref) "IDREF")) 

;such that they are not title elements 
(not (match-element? 'title x) ) ) 

(node- list-error 
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( current -node ) 

"IDREF attribute of titleref must point to a title element")) 

Example 6-21. Transformation to a different DTD 

Another simple example, this time a proper transformation, with real alterations of the 
structure. It will be shown how the transformation language specifies that a result grove 
follows a different document type than the source grove. 

(=> (current-root) ; for the grove root 
(create -root ;a root is created 
# f ;without grove identifier 
( subgrove- spec 

following the output DTD 

subgrove: (sgml -parse-prolog "output . dtd" ))) ) 

Of course, not every transformation causes a DTD change. Sometimes there are trans- 
formations that add content that is already supported by the source DTD. This is the 
case of automatic index creation. In an example to follow this case will be shown. 

Example 6-22. Automatic numbering 

This example is taken from the examples offered by James Clark in his webpage. 

Continuing with attributes, we are going into transformations that alter the structure 
of the grove. The code below generates an automatic numbering in an attribute of an 
element. Concretely it generates a numeration in the number attribute of titles and foot- 
notes. It is designed to number on one side footnotes, on the other side chapter titles, 
and on another side section titles. 

( => ( attribute " number " ;get the nodes of class attribute whose gi is number 
{ node -list -union 

( q- element 'title) ;pertaining to title elements 
(q-element 'footnote))) ;or footnote elements 
( create -sub ;and create a subgrove for each one 

( origin ( current -node ) ;whose origin is the origin of the current node 
( subgrove- spec ;defined 

node : ( current -node ) ;as a copy of the current node 

remove : ' ( implied? ) ; removing the implied property 
children : ; assigning a number as value of the attribute 
(number-children-attributes) ) 

;the sub grove created will be placed in the attributes property 
property: 'attributes))) 

;this procedure, after obtaining the number that corresponds 
;to the attribute, converts it into a subgrove-spec list 
;that represents this string in the grove 
(define (number-children-attributes) 

(string->subgrove- spec- list 

(escoger-numeracion-de -elemento 
(origin (current-node) ) ) ) ) 

;as it is an illustrative example, 

;many numbering ways are shown 

(define (escoger-numeracion-de-elemento snl) 

(cond 

; first case, a footnote is numbered 
( (mat ch- element? snl 'footnote) 




Chapter 6. The Transformation Process 



165 



;convert to string the number string 
( number- >string 

; corresponding to the position in the list 
(list-ref 

;a list with each chapter number 

;and footnote number of chapter is obtained 

(element-number-list '("chapter" "footnote") snl) 

;the second element (counting from 0) 

; of the list is taken, as it corresponds to the footnote 
1 ) ) ) 

;second case: chapter title is to be numbered 
( (match-element? snl ' (chapter title) ) 

;the number is converted into a string 
( number- >string 

;the sibling number of the chapter is obtained 
(ancestor-child-number "chapter" snl) ) ) 

;third case: a section title is to be numbered 
( (match-element? snl ' (section title) ) 

; using a string that represents a list of numbers 
( format-number-list 

; taken from the list of sibling numbers 
of the hierarchically preceding elements 

(hierarchical -number '("chapter" "section") snl) 

;using arabical numbering 
" 1 " 

;separating each number in the list with a point 
".")))) 

This example can be complex for its extension, but it is caused by the intention to offer 
a variety of numbering options. 

Example 6-23. Grouping elements 

This example is taken from the examples offered by James Clark in his webpage. 

After the previous example, we are going to study a transformation that generates a 
document that follows another DTD. The plan is simple: in a DTD a repetition of a pair 
of elements is defined, and now we want to group each pair into another element, so 
that now a sequence of the element containing the pairs will be repeated. 

(=> ;for all dt elements 
(q-element 'dt) 

;a subgrove is created 
(create-sub 

;whose origin will be the origin of the current node 
(origin (current-node) ) 

;and the subgrove is specified such that 
( subgrove- spec 

fit will be of class element 
class: 'element 
;with a gi "item" 
add: ' ( (gi "item" ) ) 

;***doubtful*** 

label: 'ignore 

;containing the current node as child 

children: (list (copiar-nodo-en-curso) ) ) ) 

;this transformation is more prioritary 
fihan the default transformation 
1 ) 
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( => ;for all dd elements 
(q-element 'dd) 

; create a sub grove following the result node 
corresponding to the preceding source sibling 
(create-follow (ipreced ( current -node ) ) 

;copying the current node 
(copiar-nodo-en-curso) ) 

;this transformation applies before the default transformation 
1 ) 

( = > ;A different DTD is specified for the result grove 
( current -root ) 

(create-root 

#f 

( subgrove - spec 

subgrove: (sgml -parse-prolog " salida . dtd" ) ) ) ) 

(=> (document -instance) 

( transformacion-por-defecto) ) 

(define (document -instance) 

( subgrove 

; is this line equivalent to ( subgrove( current-root) ) ? ? ? 

(node-property ' document -element (current-root)))) 

Example 6-24. Separation of sections 

This example is taken from the examples offered by James Clark in his webpage. 

An usual transformation is to generate a separate output document for each section 
of a document. This permits the division of a big volume of information into smaller 
portions, easier to work with. 

( => ;this transformation is executed for the root, 
and generates so many groves as sections 
(current-root) 

(map 

;for each member of the list 
(lambda (snl) 

;a root is created 
(create-root 

; whose identifier is the child number 
; of the current node 
(child-number snl) 

;and the sub grove is specified 
( subgrove -spec 

;following the divide dtd 

subgrove: ( sgml -parse-prolog "divide . dtd" ) 

: labelling the arrow with the child number 
label: (child-number sml) ) ) ) 

;converts into a list 
(node-list->list 

;the node-list compound by 

;the section elements of the whole document 

(q-element ' section) ) ) ) 

( = > ;for the section elements 

(q-element 'section) 
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;a subgrove is specified 
(create-sub 

;whose origin is the grove root 
(grove-root (current-node) ) 

;copying the current node 
(copy-of -current -node) 

;placing the grove in the document-element property 
because it is an instance 
property; ' document -element 
;and is placed following the arrow labelled 
with the child number of the node 
label: (child-number))) 

( => ;for the subnodes of section elements, 

;except the own section element nodes 
(node- list-difference 

(subgrove (q-element 'section)) 
(q-element 'section)) 

;the identity transformation by origin is applied 
( transformacion-identidad-segun-origen) ) 



Example 6-25. Compilation of figure footers 

This example is taken from the examples offered by James Clark in his webpage. 

It has been said before that not always a new DTD is used in transformations, but 
the transformation language can be used to insert elements, already supported by the 
DTD, but that can be automatically derived from the content of the document, as for 
example an index. The example below responds to a problem proposed in SGML ’93. 
A DTD allows the occurrence of figures in any place in the text, and some of them have 
captions. The idea is to compile fill the figreview element with all those figures that 
have a caption. The figures without caption are not to be compiled. The figures that are 
placed in the figreview element must be ordered lexicographically by its caption. The 
graphics can have more structure into them and it must be copied as a whole, no matter 
what it is. 

(=> (current-root) 

(let {;in the em variable the endmatter element is stored 
(em (q-element 'endmatter)) 
fin the fr variable the subgrove specification is stored 
(fr (subgrove -spec 

;as a node of class element 
class: 'element 
;with gi figreview 

add; ' ( (gi "figreview")) 

; labelling the arrow as figreview 
label: 'figreview 
;and specifying a sorting for the children 
sort-children: compare -figures) ) ) 

( i f ;when endmatter has no children 

(node-list-empty? (children em) ) 
fihefr sub grove will be inserted with origin in em 
(create-sub em fr) 
fif not, the sub grove will be placed 
; after the last child of endmatter 

(create-f ollow (last (children em) ) fr) ) ) ) 
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( => ; selecting all figures with caption 
(node-list- filter 

(lambda (fig) (attribute-string "caption" fig)) 

(q-element ' figure) ) 

;a subgrove is specified 
(create-sub 

;with origin in the grove root 
(grove-root (current-node) ) 

; copying the current node 
(copiar-nodo-en-curso) 

; placing it at the end of the figreview arrow 
label: 'figreview)) 

What could also be written: 

(=> (select-each 

fig 

(q-element 'figure) 

(attribute-string "caption" fig) ) 

(create-sub . . . ) ) 

( => ;This transformation is applied to all nodes, 

;and, as all transformations have the same priority, 
fit will also be applied to the graphics with caption 
(everything) 

(default-transformation) ) 

(define this procedure is the one that establishes 

;the ordering of the figures in the figreview element, 

;as specified in sort-children:, 

;The standard specifies that this procedure 
;must accept two parameters 

;and return true when the first goes before the second. 

(compare- figures figl fig2) 

(define (foot fig) 

(attribute-string fig "CAPTION")) 

(string<? (foot figl) (foot fig2))) 

With all those examples many practical applications have been explained. It is clear 
after the examples that a profound knowledge of the groves paradigm and the property 
set in concrete is needed to program associations; the names of the diverse properties 
of nodes must be known, along with the names of the different classes existing. 

Example 6-26. Remissions (entries pointing to other entries) 

The aim of this exercise is to automatically generate remissions for the second heads 
of entries in a dictionary. Dictionaries sort entries alphabetically depending on the first 
head. In order to be able to find an entry by the second head, it is usually placed in 
the sort point, with a pointer to the first head. The typical example is the word "goose" 
whose plural is "geese". If someone wants to find geese, he will never find goose unless 
he knows it is a plural. Usually geese will be placed in its alphabetical position with 
a reference to goose, allowing the reader to find the definition of the word in singular. 
The example below will solve this process in an automatic way. 

DTD; Entries in dictionary may have more than one head. A remission must be created 
for each head that is not the first of the entry. 
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<!ELEMENT ENTRY - (HEAD+,DEFINITION)> 

The remission element is also defined, although it will be automatically filled by the 
transformation; the writer must not care for this. 

<!ELEMENT DICTIONARY- -(ENTRY|REMISSION)+> 

<!ELEMENT REMISION - -(HEAD)> 

< ! ATTLIST REMISION FIRSTENTRY IDREF #REQUIRED> 



This is the transformation necessary to handle the problem. 

( => ;there is nothing really to do with the grove root, but as new entries will be added 
;and a lexicographical sorting of entries is needed 
(grove-root) 

(create-root 

#f 

( subgrove -spec 

node: (current-node) 

;a sort method is specified 
sort-children: sort-entries) ) ) 

(define (sort-entries el e2) 

(define ;the local procedure obtains the text of 

;the first head of an entry. As there can be many 
(head e) 

(data 

(node -list-first fit will take the first head 

(q- element 'head e) ) ) ) fit works for entries and remissions 
(string<? (head el) (head e2))) 

( => ;This expression selects all head nodes that are not the first, 
fihose causing the creation of a remission. 

; Another problem will be if the remission must be shown or not, as those 
;remissions that are lexicographically following their first heads 
;are not included, because they are superfluous. 

( select-each 
head 

(q- element 'head) 

(> (child-number head) 0) ) 

;for each selected node a result node is created 
(create- follow 

following the last entry 

(last (children (grove-root))) 

(subgrove- spec 

; being the node of class element 

class: 'element 

;with name remission 

add: ' ( (gi "remission")) 

;that, as children, will have the current node 
children : 

(list 

( copy-of -current-node ) 

;and the first of the siblings 
;that precede it, what is the same, 

;the first head will be the current node, 

;and the indexing head will be the second node 
( subgrove -spec 
node : 

(node -list-first 
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(preced (current-node) ) ) ) ) 

;it is added some attributes 
sub : 

' ( (attributes 

(subgrove -spec 

class: 'attribute-assignment 
add : 

' {;a firs tentry attribute 

(name " f irstentry " ) 

; whose value will be 
;the id of the current node, 

;not the entry id 
(value 

(string->subgrove -spec- list 
(attribute 
' id 

(ancestor "entry" ))))))))))) 



6.5.5. Transliteration 

Each node in a result grove can have a non-nodal transliteration property whose value 
is an object of type transliteration-map. If no transliteration property is specified for a 
node, the value of the transliteration property is the value of the transliteration property 
of the origin of the node. If no transliteration property is specified for the root node of 
a result grove, then the value will be an empty transliteration map. 

define-transliteration-map 



(def ine-transliteration-map variable '(char (char ...))) 



Binds variable to an object of type transliteration-map specifying a translit- 
eration in which certain characters are represented by sequences of one or more 
other characters. The first char is represented by the sequence ( char . . . ) . 

transliteration-map? 



(transliteration-map? obj ) 



Returns #t when obj is of type transliteration-map. 

For each consecutive sequence of data-char nodes in the result grove with the same 
transliteration property, the sequence of characters that the sequence of characters in 
the result grove represents with respect to the transliteration-map will be output instead 
of the sequence of characters in the result grove. In case of ambiguity, the longest list 
will be used. 

6.5.6. SGML Document Generator 

Once the transformation process has taken place, an SGML document is generated as 
output. As tt was explained in Chapter 1, the result grove of the transformation can’t 
be directly passed to the style process, because the grove plans from the transformation 
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specification and the style specification may differ. For this reason, there is an internal 
SGML document generation between both processes. 

Summarizing the process, from a parsed SGML document a source grove is constructed 
that is transformed by means of associations into a result grove. The SGML document 
generator produces an SGML document or subdocument from a result grove. 

Prior to the document generation, the grove resulting of a transformation should be 
tested for validity. This test is performed in terms of a verification grove, which is the 
grove that would be built by parsing the result SGML document with the full grove plan 
of the SGML property set. An SGML document will be generated such that it meets 
the requirements of the verification mapping, that maps each node in the result grove 
to a node in the verification grove. 

From the requirements of the verification mapping it is deduced that: 

• Nodes can only be placed in nodal properties. 

• Result groves don’t exhibit values for derived properties. It means that derived prop- 
erties will be automatically handled, if necessary, by the SGML generator after trans- 
formations take place. 

• Non-nodal properties in the optional category have a value (null or not null) in the 
verification grove independently from the value of the properties in the result grove. 

• Nodes in the mayadd category are nodes that may occur in the verification grove 
without counterpart in the result grove. These nodes may be added after the transfor- 
mations by the SGML document generator. These are the only nodes in the verifica- 
tion grove that have no corresponding nodes in the result grove. 

• Nodes of the verification grove correspond to nodes in the result grove unless they 
are in the mayadd category. 
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7.1. Introduction 

The last phase of the DSSSL processing model is the formatting process. The style 
language controls the manner in which this formatting is done. 

The ultimate goal of the formatting process is to generate something, from the results 
of the previous processes, that a person can understand. Using the classic elements of 
typography, spacing and layout, some parts of the content are made to stand out from 
the rest in a way that makes grasping their meaning easy. This is a complex task with 
an important artistic component of harmony and composition. 

The DSSSL standard does not define the entirety of this process: it divides it into phases 
of which it specifies some and leaves the remainder undefined. 

The formatting process, as defined by the standard, begins with an SGML source doc- 
ument. This document can be either the original source document or the result of an 
earlier transformation of the original source document. 

After analyzing the document, a source grove representing it is built. The output grove 
of the transformation process is not used directly as the style specification may define 
its own grove plan which may differ to that used for the transformation. This is why 
an intermediate SGML document is generated between the transformation process and 
the formatting process, instead of passing the result grove of the transformation process 
directly to the formatting process. 
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Figure 7-1. The style process 




With the style language, one defines the desired formatting of each part of the grove. 
This formatting is specified using a set of preestablished flow objects created by con- 
struction rules (so called because they construct the flow objects). 

Flow objects are an abstract representation of tasks that the formatter must perform. 
Each flow object has a class, which defines the type of task, and characteristics, which 
permit the parameterization of the task. 

Just as a grove is a hierarchical data model, the flow objects, as they are constructed, 
form a tree. There are flow objects that contain other flow objects. The contained objects 
are attached to ports of the containing objects. There are also atomic flow objects which 
have no ports and so may not contain other flow objects. 

The flow objects only define in an abstract manner the task that the formatter must 
perform. The formatter must be capable of performing the tasks as specified by the 
flow object tree. The DSSSL specification stops at this point. The way in which the 
flow object tree is represented, how the tree is passed to the formatter, how the formatter 
works and how it is made to perform the tasks in the specified way are not defined by 
the standard. 

Regardless, the standard specifies that the result of formatting a flow object is a rectan- 
gular box, called an area, of fixed height and width. 

The style language is formed of three types of expression: 

• Construction rules: specify how, given a node in the source grove, the nodes in the 
flow object tree should be created. See Section 7.2.1. 

• Mode definitions: group construction rules together so that they are executed when 
the processing mode is activated. See Section 7.2.15. 

• Style definitions: group characteristic specifications so they can be used as a schema. 
See Section 7.2.11. 



7.2. Tutorial of the Style Language 

7.2.1 . Construction rules 

Every stylesheet consists of a series of sentences that convert structural elements into 
formatting objects. In DSSSL, the syntax to do this is called a construction rule because 
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it constructs a part of the flow object tree from zero or more nodes in the grove. 

There are five types of construction rule. From the most specific to the most general 
they are: 

query 



(query query-expression construct-expression priority-expression) 

It applies construct-expression to the nodes returned by 
query-expression. It requires the query feature and is activated by SDQL 
expressions. 



(id unique-id construct-expression) 

This rules is used to process elements according to their IDs. 

element 

(element gi construct-expression) 

Element rules affect all the elements with the same gi. 

Example 7-1. element 

(element para . . . ) 

This rule processes all para elements. 

(element list construct-expression) 

An element rule can also qualify the elements with a list. See Section 7.2.3. 

default 

(default construct-expression) 

The default rule is applied when no other rule is applicable 

root 



(root construct-expression) 



That rule affects the node of class sgml -document, Section 4.8.1, that is, the 
root of the grove. 

Normally, one wants to use the same process for all elements of the same name, and so 
one uses element rules. For this reason they are the most commonly used rules. So, the 
majority of our examples will use these rules. At the end of the day, all the rules work 
in a similar fashion. 
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7.2.2. Construct Expressions 

Using construction expressions, flow objects are created which the construction rule 
inserts in the flow object tree. In fact, these are called sosofos, which will be explained 
below, see Section 7.2.8. 

make 



(make flow-object-class-name characteristics force !c 

ref erence-value-types use: content-map: label:) 



A make expression causes the construction of a flow object of the specified class 
and characteristics. 

• flow-object-class-name is the name of a flow object class. This is ex- 
plained in Section 7.3. 

• characteristics are any non-inherited characteristics that belong to the 
flow object class or any inherited characteristic. This is explained in Section 
7.2.12. 

• force !c is any inherited characteristic. Their use is explained in Section 
7.2.12. 

• ref erence-value-types give values to reference types. Their use is ex- 
plained in Section 7.3.3.4.2. 

• use : allows the specification of concrete styles. Styles are explained in Section 
7.2.11. 

• content-map : allows the renaming of ports. Ports are explained in Section 
7.2.6. 

• label : allows the labelling of flow objects. This is explained in Section 7.2.6. 
Example 7-2. Make Expression 

(element para 
(make paragraph 

font-family-name; "Arial")) 

In this example, when a para element appears in the document, a flow 
object of the paragraph class will be created in the flow object tree. The 
font- family-name : characteristic of this object, which specifies the font, 
will be assigned the value Arial. Paragraph, one of the classes defined 
by DSSSL, represents a paragraph. Font- family-name : is one of the 
characteristics defined for the paragraph class. 



7.2.3. Contextualization of Elements 

Element rules allow the selection of elements that appear within other elements. 
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Example 7-3. Element Rule with Context 

(element (section para) 

(make paragraph) ) 

In this case, para elements within section elements generate paragraph objects. 

7.2.4. Precedence between Multiple Construction 
Rules 

It is possible that multiple rules will apply to a single element. DSSSL establishes a 
priority mechanism, such that the most specific construction rule that matches a node 
is applied to it. A more specific rule has greater precedence than a more general rule. 

Priority order between construction rules 

(highest precedence) 

• A construction rule in a mode has more precedence than those in the default pro- 
cessing mode. See Section 7.2.15. 

• A construction rule in one style-specification part has more precedence 
than those rules in subsequent parts. 

• query construction rules. Higher priority expressions specify an ordering between 
query rules. 

• id construction rules. 

• element construction rules with qualified (contextualized) elements. 

• element construction rules. 

• default construction rule. 

• root construction rule. 

It is an error for two rules with the same priority to apply to the same node. 

Example 7-4. Priority by Context in Element Rules 

(element para 

(make paragraph) ) 

(element (section para) 

(make paragraph 

f ont- family-name : "Arial")) 

In this example, the second rule has a higher priority than the first because the first 
only specifies the selection of para elements whereas the second requires that the 
para elements occur within section elements. This allows paragraph objects that 
are created to vary from one case to the next. 
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next-match 



(next -match) 



Forces the application of the next construction rule of lesser precedence. Returns 
the sosofo resulting from applying the next most specific construction rule that 
matches the current node. 

(next-match style) 

Forces the application of the next construction rule of lesser precedence. Returns 
the sosofo resulting from applying the next most specific construction rule that 
matches the current node, specifying that style as the current overriding style 
for the evaluation of that construction rule. 

Example 7-5. next-match 

(element (a x) 

(if (first-sibling?) 

(next -match) 

(make sequence) ) ) 

(element x 
(make para) ) 

The rule with the highest precedence is the one that contextualizes element x 
within a. For all the elements x within elements a this is the rule that will fire. 

But inside the rule, for the first siblings, next-match is called, what forces this node 
to be processed with the next rule of lower precedence, in this case the one that 
processes elements x without context. 



7.2.5. Atomic and Non-atomic Flow Objects 

In the same way that the elements of an SGML document are nested to form a hierar- 
chical structure with the shape of a tree, creating flow objects for these elements creates 
a tree of flow objects. For this to work, there are some objects that may contain other 
objects. For example, the paragraph object may contain other objects. There are also 
objects, such as the character object, that may not contain other objects. Classes that 
may not contain other objects are called atomic. 

When a flow object may contain other objects, its construction rule may contain other 
construction rules. 

Example 7-6. Nested Construction Expressions 

(element para 

(make paragraph 
(make character 
char : " a ” ) ) ) 

In this example, a character object (atomic) is created inside a paragraph object (non- 
atomic). 
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The construction of flow objects within other flow objects may be done explicitly as 
in the previous example or implicitly according to the structure of the document being 
processed. 

Example 7-7. Placement of Sub Flow Objects Guided by Structure 

Given the fragment <A><B></Bx/A> and the rules 
(element A 

(make paragraph) ) 

(element B 

(make character 
char : " a " ) ) 

The result is the same as that of the previous example: an atomic character flow object 
linked to the element B by the rule element B, inside a non- atomic paragraph flow 
object linked to the element A by the rule element A. As the element B occurs within 
the element A, the character is placed within the paragraph which is equivalent to the 
previous example. 



7.2.6. Ports 

Flow objects may be attached to other flow objects at defined points ready to receive 
them. These points are called ports. Atomic objects are so named because they do not 
have any ports capable of receiving other objects. Amongst objects that do have ports, 
normally one of these ports is the principal port which is identified as #f, the others 
being identified by names that are assigned to them. Many objects have predefined 
ports but some allow the programmer to define the number of ports and their names. 

For example, the paragraph class has a single port which is its principal port. The 
classes used to represent mathematical formulae tend to have several ports, as is the case 
with the radical class which has two ports: the principal port and another named 
degree. The page -sequence class allows the programmer to define its ports. 

When one flow object is constructed within another, it is attached by default to the 
principal port, if there is one. To attach it to another port, the desired port must be 
named by putting its name in the label : keyword of the make procedure. 

Example 7-8. Attaching Flow Objects to Ports 

(element a 

(make radical 
(make character 
char: "x" 
label: 'degree))) 

In this example, the rule attaches the constructed character flow object to the port named 
degree. DSSSL defines a flow object class called radical (see Section 7.3.24.7) that 
has a port named degree. 

DSSSL allows the local modification of the port names to accommodate the tastes or 
preferences of the programmer or application, using the keyword content-map:. 
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Example 7-9. Local Modification of Ports 

(element a 

(make radical 

content-map: ' ( (#f base) (degree #f ) ) ) ) 

In this example, a flow object of the radical class is constructed and is modified 
locally so that the degree port becomes the principal port and the original principal port 
is renamed base. 

7.2.7. Area Types 

Semantics are given to flow objects by the concept of areas. The result of formatting 
a flow object other than the root is a sequence of areas. An area is a rectangular box, 
of fixed height and width, that may itself contain other areas or a glyph as a terminal 
element. Furthermore, information or a tag may be attached to an area depending on 
the flow object that produced it and the context in which it will be used. 

There are two types of area each of which is treated differently when formatted. 

Display areas are positioned according to area containers that have a local orientation 
(that is they have a top that is independent of the rest of the document). 

Figure 7-2. Diagram of an area container 
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Inside an area container, display areas are placed one after the other. 
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Figure 7-3. Placement of display areas in area containers 
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Figure 7-4. Diagram of a displayed area 
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Inline areas form parts of lines (that is they follow the writing flow). 





182 



Chapter 7. The Style Process 



Figure 7-5. Diagram of an inline area 
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Lines are formed by placing inline areas next to eachother. The first area is placed, 
and the position-point of the area takes the role of the placement-point of the line. The 
second are places its position-point together with the escapement-point of the previous 
inline area, and so on. All the points, if united, would finally form a line, which is 
named the placement-path of the line. 

Figure 7-6. Formation of lines with inline areas 




When a flow object, upon being formatted, generates a sequence of inline areas, it is 
said to be inlined. For example, character is an inline class of object. Similarly, 
when a flow object, upon being formatted, generated a sequence of display areas, it is 
said to be displayed. Paragraph is a displayed class of object 

The standard defines some classes of object as inlined, others as displayed and others 
that behave as inlined or displayed depending on their containing objects. Some ports. 
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between other restrictions, limit the type of object that they accept to either inlined or 
displayed. 



7.2.8. Sosofos 

Thus far, the explanation has been simplified, giving the idea that flow objects are 
created and inserted individually in the tree. However, the mechanism is somewhat 
more complex: the flow objects are inserted grouped in sequences of specifications of 
flow objects, also called sosofos. 

Let us evaluate the situation. An element contains five subelements. The parent con- 
structs a flow object with a single principal port and each of the children constructs an 
arbitrary flow object. When the second child’s turn comes, the port is already occupied 
by the first child. If the objects were to manage themselves individually, the second 
child would have to displace the first child. 

It’s clear that this scenario will lead to trouble. For this reason, construction expressions 
always return a sequence of flow objects which may be empty. The style language 
manages these sequences of objects. 

In addition to the make procedure, there are other procedures that manage sosofos. 

empty-sosofo 



(empty-sosofo) 

This procedure returns an empty sosofo. It is used usually to suppress the content 
of an element. 

Example 7-10. Suppression of an Element’s Content 

(element a 

(empty-sosofo) ) 

literal 



(literal string ...) 



Returns a sosofo composed of the characters of its string arguments. 

Example 7-11. Text Generation 



(element a 

(literal "a")) 

sosofo-append 



(sosofo-append sosofo ...) 

Returns the concatenation of its sosofo arguments. Normally used when a con- 
struction rule must generate a series of objects. 
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Note: The result is similar to that obtained by using the sequence flow object class, al- 
though the sequence class allows the specification of inherited characteristics. See Sec- 
tion 7.3.20. 

Example 7-12. Construction of Multiple Objects in a Single Rule 

(element a 

(sosofo -append 
(make radical) 

(literal "hi " ) ) ) 

There is also a group of procedures that manipulate the labels of the objects in a sosofo. 
Remember that the labels are used to connect flow objects to ports. 

sosofo-label 



(sosofo-label sosofo symbol) 



Assigns the label symbol to all the objects in the sosofo that are unlabelled. 

sosofo-discard-labeled 



(sosofo-discard-labeled sosofo symbol) 



Discards the flow objects in sosofo that are labelled with symbol. 

7.2.9. Processing of Children 

When processing an SGML document, the complete result is not available until all the 
children have been processed. This means that at some point during the processing of 
an element, the subelements must also be processed. In DSSSL, 

process-children 



(process -children) 



This procedure represents the point when children shall be processed and returns 
the sosofo resulting from the concatenation of the sosofos of the children. 

The point at which the processing of the children should start is not always the same 
and depends on the desired format of the document. 

An element may generate text before showing the contents of its children, in which 
case the processing of the children occurs last. This is the case for a list of items where 
a symbol is placed at the start of the first line of each item to mark it. The symbol 
precedes the content of the line. 
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Example 7-13. Processing Children Last 

(element item 
(sosofo-append 
(literal "x") 

(process-children) ) ) 

Another case is when an element generates text before and after showing the contents 
of its children. This would be the case when a comment is shown between parentheses. 

Example 7-14. Processing the Children in the Middle 

(element comment 
(sosofo-append 
(literal "(") 

(process -children) 

(literal ")"))) 

And finally there is the case where an element generates text after showing the content 
of its children. This would be the case when, for an element sentence, a full stop is 
added at the end. 

Example 7-15. Processing Children First 

(element sentence 
(sosofo-append 

(process -children) 

(literal "."))) 

When a non-atomic object is created, the use of the process-children procedure is not 
obligatory. When the make procedure does not contain a sosofo generating procedure, 
it is assumed to use process-children. 

Example 7-16. Implicit Processing of Children 

(element a 

(make paragraph) ) 

is equivalent to 

(element a 

(make paragraph 

(process-children) ) ) 

However, when there is an expression that returns a sosofo within a flow object, if the 
children are to be processed, it must be done explicitly. 

Example 7-17. Explicit Processing of Children 

(element a 

(make paragraph 
(literal "hello") 

(process-children) ) ) 

is not the same as 
(element a 

(make paragraph 

(literal "hello"))) 
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because literal evaluates to a sosofo and so the children will not be processed unless it 
is indicated that they should be. The second construction rule would cause the replace- 
ment of the content of the a element by "hello". 

There are other procedures that cause the processing of children in various ways. 

process-children-trim 



(process -children- trim) 



When processing the children, leading and trailing white space is removed. White 
spaces are an SGML concept. They are mainly characters that are interpreted as 
text separators. 

process-matching-children 

(process-matching-children pattern . . . ) 

Processes the children that match any of the patterns. Patterns are defined as for 
match- element? 

Example 7-18. Processing Children by Context 

(element a 

(make paragraph 

(process-matching-children ' (a b) ) ) ) 

See Also: match-element?. 

process-element-with-id 



(process-element-with-id string) 



An element may also be processed by its identifier string. This will normally 
happen when the SGML document has an IDREF attribute specified. To use this 
procedure, the DSSSL processor must support the cross-reference feature. 

Example 7-19. Processing Referenced Elements 



(element a 

(make paragraph 

(process-element-with-id 



(at tribute- string 
" idref " 

(current -node) ) ) ) ) 



7.2.10. Multiple Processing of Children 

A call to any of the procedures process-children, process-children-trim, 
process-matching-children or process-first-descendant is a descending recursive call 
because it causes the processor to go down into the children nodes. The only three 
cases when they don’t cause descending recursive calls are: 

• during the evaluation of a call to process-node-list. See Section 7.2.16. 
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• during the evaluation of a call to process-element-with-id. See Section 7.2.9. 

• during the evaluation of the value of a reference value. See Section 7. 3. 3. 4.2. 

The multi-process feature allows two descending recursive calls both made when the 
same node is the current node (Section 5.3) and when the same processing mode (Sec- 
tion 7.2.15) is the current one. Otherwise, multiple processing is an error. 

The process-children procedure may be used as many times as desired within a make 
expression. This gives the programmer many options when formatting a document. 

Example 7-20. Multiple Processing of Children in a Construction Expression 

(element a 

(make paragraph 

(process -children) 

(literal 

(process-children) ) ) 

In this example, for each a element, a paragraph will be generated that contains the 
content of the element repeated and separated by two dashes. 

Processing children multiple times in the same construction rule is useful, above all, 
for generating tables of contents. 

Example 7-21. Multiple Processing of Children for Index Generation 

(element book 
(make paragraph 

(literal "Index of Examples:") 

(process-matching-children ' (example title) ) 

(process-children) ) ) 



7.2.11. Styles 

As has already been explained, in make procedures characteristics may be specified that 
parameterize behavior depending on the class of object being processed. When many 
objects need to use similar definitions, the style mechanism helps reduce the task of 
writing. 

Style 



(style characteristics) 



Styles are groupings of characteristic specifications that can be reused in multiple 
places. The idea is that a style is defined, using the style procedure, as a group- 
ing of characteristic specifications, that may be used later when flow objects are 
constructed. 
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Example 7-22. Definition and Use of Styles 

(define body-style 
(style 

font -family -name : "Times New Roman")) 

(element a 

(make paragraph 
use: body-style)) 

Furthermore, styles may be housed in a style repository, allowing their reuse for 
the processing of multiple documents. This allows all the documents of the an 
organization to have a similar appearance and thus to be recognizable as a prod- 
uct of the same organization. The mechanism to do this is to store definitions in 
an external document and reference it in the customization layer as explained in 
Section 2.6. 

merge-style 



(merge-style style . . . ) 

Returns a style object merging s tyl e .... The first characteristic specification 
occurring in the style parameters is the one that applies for each characteristic 
specification of the resulting style object. 

Example 7-23. merge-style 

(merge-style 

(style 

font-size: 15pt) 

(style 

font-size: lOpt 
font-posture: 'italic)) 

is equivalent to 

(style 

font-size: 15pt 
font-posture: 'italic) 



7.2.12. Inheritance of Characteristics 

Normally, when writing a text, one uses a concrete font and doesn’t change it randomly. 
For the majority of the document text, one uses a small, but legible, point size so that 
the number of pages is not excessive. Sometimes, titles are written in a different font 
to distinguish them from the body of the document and normally a larger font size and 
heavier weight, relative to the body of the text, are used. Similarly, footnotes are usually 
written in a smaller font size than the body of the document. 

That is to say, in the usual practice of writing, the desired result is a document that 
is comfortable to read, with an agreeable visual aspect. The typeface and size of the 
letters for the most part do not vary, changing only to highlight a concrete and specific 
part. When the size of the letters changes, it is done by augmenting it or diminishing it 
relative to the basic size of the document. 
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DSSSL has appeared at a time in which the science and art of the document composi- 
tion are highly evolved and must be able to support all these preexisting techniques. 

As an SGML document is processed, the flow objects constructed form a tree. For 
some elements, characteristics are specified. DSSSL applies an inheritance mechanism 
to the elements’ characteristics. When an object specifies a characteristic, the objects 
within this element receive, through this inheritance mechanism, the same value for the 
characteristic. All characteristics in DSSSL are inherited unless explicitly specified not 
to be. This permits the application of classic methods of composition. 

Example 7-24. Inherited Characteristics 

(element a 

(make paragraph 

font- f ami ly-name : "Arial" 

(make radical 

(process-children) ) ) ) 

In this example, the paragraph object specifies the font Arial and the radical object, 
through the inheritance mechanism, receives this same specification, meaning that the 
radical object will use the same font without the need to explicitly specify it. In the same 
way, when the process-children procedure is evaluated, all the children will inherit this 
same characteristic. 

The inheritance mechanism is very useful because it reduces the number of times char- 
acteristics need to be specified. It is only necessary to specify characteristics when they 
are non-inherited, when they haven’t been previously specified or when the inherited 
specification is inappropriate and must be modified. When a characteristic is specified 
for a flow object, the line of inheritance for that characteristic is cut. 

Example 7-25. Changing an Inherited Characteristic 

(element a 

(make paragraph 

font- family-name : "Arial" 

(literal "Formula:") 

(make radical 

font -f ami ly-name : "Courier" 

(process-children) ) ) ) 

In this example, the paragraph object specifies the font Arial in which the text “For- 
mula:” will appear, but the radical object breaks the line of inheritance by specifying 
the font Courier. When the process-children procedure is evaluated, the children will 
inherit the value defined by the radical object, that is. Courier. 

The inheritance mechanism may be forced to prevent descendent flow objects redefin- 
ing the value they receive. 

Example 7-26. Forced Inheritance of Characteristics 

(element a 

(make paragraph 

force ! font -f ami ly-name : "Arial " ) ) 




190 



Chapter 7. The Style Process 



In this example, the paragraph object forces all its children to inherit the font Arial so, 
even if a child specifies another value for the characteristic, it will inherit the value 
Arial regardless, invalidating the change. 

In the standard, every object has its own group of characteristics. However, when con- 
structing a flow object, the specification of a characteristic that the object does not 
support is permitted so that child objects may inherit it. This means that, when con- 
structing an object, one should not think only of the characteristics that affect it but 
also of the characteristics that affect its children that might be specified in the object 
itself. This mechanism is only permitted for inherited characteristics. 

7.2.13. Accessing Characteristic Values 

The classic pagination mechanism uses the size of the letters in the body of the text 
to calculate a larger size for the titles and a smaller size for the footnotes. This means 
that, when specifying the font size to be used for the titles, it is necessary to obtain the 
current font size of the body so that it may be increased or decreased appropriately. 

In DSSSL, when specifying the value of a characteristic c, the inherited-c procedure is 
available to retrieve the value received by the chain of inheritance for the characteristic. 
This value may be used for internal calculations. 

Example 7-27. Specifying Characteristics Relative to Inherited Values 

(element footnote 
(make paragraph 

font-size: (/ (inherited-font-size) 2))) 

The current value of other characteristics can also be obtained using the actual-c pro- 
cedure. Use of actual-c requires the actual-characteristic feature. 

Example 7-28. Specifying Characteristics Using the Values of Others 

(element para 
(make paragraph 

line-spacing: (+ (actual-font-size) 1))) 

In DSSSL arguments are evaluated in the order they are specified. Care must be taken 
when defining characteristics by means of the value of other characteristics; values will 
be assigned in specification order, and prior assignments will modify the value of the 
next characteristics assignments. 

7.2.14. Order of Priority in the Definition of 
Characteristics 

In a make expression, the value of an inherited characteristic c is obtained with the first 
of the mechanisms below that is successful!. 

1. by taking the value that has been specified by the top-most forceic: climbing up 
the flow object tree. 

2. from the overriding style imposed by next-match. See next-match. 
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3. from c:. 

4. from use:. 

5. from (inherited-c). 

In the case of non-inherited characteristics, if a value is not specified, the default value 
is used. 

7.2.15. Processing Modes 

Up to now, we have focused on explaining sosofo construction expressions. Now, we 
are going to focus on construction rules. 

In a style specification there will usually be a number of rules for processing elements. 
It is possible that, in a given moment, only some of these rules should be active. The 
mode mechanism allows this to be done. 

mode 



(mode mode-name construction-rules) 



Returns a mode named mode -name containing construction-rules. 

A mode is a grouping of construction rules that are only applied when the mode is 
active. Modes are defined using the mode procedure. 

Example 7-29. Mode Definition 

(mode m 

(element e 

(make paragraph) ) ) 

with-mode 



(with-mode mode-name expression) 



Processes expression using the construction rules in mode -name in addition 
to the construction rules in the initial processing mode, see below. 

Once a mode has been defined, it can be activated to process subgroves using the 
procedure with-mode in a construction expression. 

Example 7-30. Activation of a Processing Mode 



(element h 

(make paragraph 
(with-mode m 

(process-children) ) ) ) 

In this example, the children will be processed using the rules contained in the 
mode m. 
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The style language always works in modes. There is an initial processing mode that 
contains all the rules that are not defined within a mode. The rules of the initial mode 
are always active, but according to the rules of priority, Section 7.2.4, a rule defined 
within a named mode has greater priority than a rule in the initial mode. 

Example 7-31. Table of Contents as a Processing Mode 

(element document 
(make sequence 

(process-matching-children ' title) 

(make paragraph 
font-size: 18pt 

(literal "Table of Contents: ")) 

(with-mode table-of-contents 

(process-matching-children 'section) ) 

(process-children) ) ) 

(mode table-of-contents 
(element section 
(make paragraph 

(literal "Section-") 

(literal (format-number (child-number) "1")) 
(process-first-descendant 'title))) 

(element title 

(process-children) ) ) 



7.2.16. Processing Node Lists 

process-node-list 



(process-node-list query-expression) 



The use of this procedure requires the query feature. The construction rule is ap- 
plied to the node list obtained by querying the grove using the full query language. 
On termination, the resultant sosofos are concatenated. 

Example 7-32. process-node-list 



(element book 
(wity-mode toe 

(process-node-list (q-element '(section title)))) 
(process-children) ) 

map-constructor 



(map-constructor procedure query-expression) 



The use of this procedure requires the query feature. The procedure is applied to 
each node returned by the query expression. The procedure may not take any argu- 
ments and, in the context of the procedure, ( current - node ) refers to the node 
of the returned node list currently being processed. On termination, the resultant 
sosofos are concatenated. 
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Example 7-33. map-constructor 



(element xref 

(map-cons true tor 

(lambda () (process-xref ( current -node) ) ) 

(element (attribute-string "REFID" ) ) ) ) 

Where process-xref is a procedure defined somewhere. This part of code is bor- 
rowed from Example 7-44. 



7.2.17. Spaces 

Spaces are used to describe the desired line separation. Just as there are two types of 
area, inline and displayed, there are two types of space, inline-space and display-space, 
which are used to separate areas of the corresponding type. Inline-spaces are used in 
the character flow object class and so their explanation can be found in Section 7.3.10. 
Display-spaces are used in various common characteristics, and so are explained in 
Section 7.3.1. 



7.2.18. Font Information 

To obtain a font property, the procodurt font-property is used. Use of procedures in this 
section requires the font-info feature. 

font-property 



(font-property public-id list 

#!key size: name: family-name: weight: posture: structure: 
proportionate-width: writing -mode : ) 

Returns the values of the list of properties in the public-id font resource. 



7.2.19. Colors 

The standard offers the following procedures for the specification of colors. 

color-space? 



(color-space? ob j ) 

This is a boolean procedure that returns #t if obj is an object of type color-space. 

color-space 



(color-space public-id arg ...) 

Returns an object of type color-space. Color spaces are specified with the string 
"ISO/IEC 10179: 1996//Color-Space Family: :familyname”. The list below are the 
family names allowed by DSSSL. 
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• "Device Gray" 

• "Device RGB" 

• "Device CMYK" 

• "Device KX" 

• "CIELAB" 

• "CIELUV" 

• "CIE Based ABC" 

• "CEE Based A" 

Device Gray family is a family that depends on one parameter specifying the grey 
level. 

The rest of the families are implemented using a three dimensional space. For this 
reason they require three numeric parameters specifying the three values of the 
coordinates in the three dimensions. 

In RGB the three values correspond to Red, Green and Blue, using an additive 
color model. 

CMYK is a substractive color model representing the behaviour of paints. Cyan 
Magenta Yellow, and there is a fourth value, K, specifying the brightness. The 
three dimensions CMY are defined to sum a fix value, and thus the third value, Y, 
is functionally dependent on the other two, reason for which it is suppressed as a 
parameter. The third parameter is the brightness K. 

CIE families were created to cover all existing colors, overcoming the limitations 
of RGB families. They also require three parameters. 

color? 



(color? ob j ) 



This is a boolean procedure that returns #t if obj is an object of type color. 

color 



(color color-space arg . . . ) 

Returns an object of type color from the color space specified by color-space. The 
arguments depend of the family used. 

Example 7-34. color and color-space 

Defining a color using the RGB family. 

(color 

(color-space "ISO/IEC 10179 : 1996/ /Color-Space Family: : Device RGB) 

10 0 ) 
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7.3. Detailed Explanation of the Flow 
Object Classes 

In the previous examples some flow object classes and some of their characteristics 
have been introduced. The concept of a flow object hierarchy has also been introduced. 
The standard establishes some rules that must be fulfilled when the flow object tree is 
constructed; some flow objects can only be attached to certain ports. 

Of the flow object classes, there are only three that can be placed at the root of the 
flow object tree; simple-page-sequence, page-sequence and scroll. The 
remaining classes will always be either attached to a port, when they are labelled, or 
will occur as the value of a characteristic that accepts unlabelled flow objects. 

All flow objects have characteristics that modify the manner in which they are format- 
ted. The set of characteristics can be divided into two groups: common characteristics, 
or those that appear in several classes, and uncommon characteristics, those that occur, 
in most cases, in only one class, and can be considered a property of this class. 



7.3.1. Common Characteristics 

Before the different flow object classes are explained, the common characteristics 
shared by most of them will be introduced. This will help to reduce the length of the 
explanation of each flow object class, limiting it only to the uncommon characteristics, 
and adding to the explanations of the common ones when needed. 

Table 7-1. Common Characteristics 



Characteristic 


Inh 


Values 


Default 


Description 


keep-with- 

previous?: 


no 


boolean 


#f 


Specifies whether the flow object is 
kept together with the previous one. 


keep-with-next?: 


no 


boolean 


#f 


Specifies whether the flow object is 
kept together with the next one. 


keep: 


no 


#t, page, 
column- set, 
column, #f 


#f 


Specifies whether this flow object is 
kept together in one area. #t means 
the smallest area possible. #f means 
ignore. Any other value indicates the 
type of area within which this flow 
object must be kept, in which case 
the flow object must have an 
ancestor of the appropriate class. 


may-violate- 

keep-before?: 


no 


boolean 


#f 


Specifies whether the keep : 
restrictions of ancestors affecting 
this flow object and the previous one 
is not respected. 





196 



Chapter 7. The Style Process 



Table 7-1 (cont.). Common Characteristics 



Characteristic 


Inh 


Vaiues 


Default 


Description 


may-violate- 

keep-after? 


no 


boolean 


#f 


Specifies whether the keep : 
restrictions of ancestors affecting 
this flow object and the next one is 
not respected. 


break-before: 


no 


#f, page, 
page-region, 
column, 
column-set 


#f 


Specifies that the flow object starts 
an area of the specified type when a 
break occurs before it. 


break-after: 


no 


#f, page, 
page-region, 
column, 
column-set 


#f 


Specifies that the flow object ends 
an area of the specified type when a 
break occurs after it. 


space-after: 


no 


(display- space ...) 


no space 


Specifies the space to be inserted 
after the flow object in the 
placement direction. 


space-before: 


no 


(display-space ...) 


no space 


Specifies the space to be inserted 
before the flow object in the 
placement direction. 


position- 

preference: 


no 


#f, top, bottom 


#f 


Specifies whether this flow object 
occupes only one of the bottom or 
float zones when directed into a port 
flowed into both zones of a 
column-subset. 


writing-mode: 


yes 


left-to-right, 

right-to-left, 

top-to-bottom 


left-to- 

right 


The direction determined by the 
writing-mode is perpendicular to the 
placement direction. Use of 
right-to-left requires the bidi feature. 
Use of top-to-bottom requires the 
vertical feature. 


span: 


yes 


integer>0 


1 


Specifies the number of columns 
that this flow object spans. It applies 
if the flow object is directed into a 
port flowed into the top-float, 
bottom-float or body-text zone of a 
spannable columnset. 


span- weak?: 


yes 


boolean 


#f 


Specifies whether this flow object 
spans weakly rather than strongly. It 
applies if the flow object is directed 
into a port flowed into the top-float, 
bottom-float or body-text zone of a 
column-subset. 
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Table 7-1 (cont.). Common Characteristics 



Characteristic 


Inh 


Values 


Default 


Description 


font-family- 

name: 


yes 


#f, string 


iso-serif 


Specifies the font family. Support of 
iso-serif, iso-sanserif and 
iso-monospace families is ensured 
by the standard. 


font-weight 


yes 


#f, 

not-applicable, 
ultra-light, 
extra-light, light, 
semi-light, 
medium, 
semi-bold, bold, 
extra-bold, 
ultra-bold 


medium 




font-posture: 


yes 


#f, 

not-applicable, 
upright, oblique, 
back-slanted- 
oblique, italic, 
back-slanted- 
italic 


upright 




font-structure: 


yes 


#f, 

not-applicable, 
solid, outline 


solid 




font- 

proportionate- 

width: 


yes 


#f, 

not-applicable, 

ultra-condensed, 

extra-condensed, 

condensed, 

semi-condensed, 

medium, 

semi-expanded, 

expanded, 

extra-expanded, 

ultra-expanded 


medium 


Specifies the separation between 
characters. 


font-name 


yes 


#f, string 


#f 


Specifies the public identifier of the 
font. Its use is alternative to the 
fon t - fami ly-name : , 
font-weight ;, 
fon t -pos t ure : , 
font-structure : and 
font -proportionate-width : 
characteristics. 


font-size: 


yes 


length 


lOpt 
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Table 7-1 (cont.). Common Characteristics 



Characteristic 


Inh 


Values 


Default 


Description 


language: 


yes 


#f, symbol 
(IS0639) 


#f 




country: 


yes 


#f, symbol 
(IS03166) 


#f 




start-indent: 


yes 


length- spec 


Opt 


Specifies the indentation on the 
starting side of the writing-mode. 


end-indent: 


yes 


length- spec 


Opt 


Specifies the indentation on the 
ending side of the writing-mode. 


inhibit-line- 

breaks?: 


yes 


boolean 


#f 


Specifies whether line breaks are 
inhibited before and after each area 
inside this object. 


break-before- 

priority: 


no 


integer 


0 


Specifies whether a break is allowed 
before this flow object. A break is 
allowed when its priority is even. 
The priority is the maximum 
between the before and after 
characteristics of consecutive flow 
objects. 


break-after- 

priority: 


no 


integer 


0 


Specifies whether a break is allowed 
after this flow object. A break is 
allowed when its priority is even. 
The priority is the maximum 
between the before and after 
characteristics of consecutive flow 
objects. 


color: 


yes 


color-space 


Default 
color in 
Device 
Gray 




layer: 


yes 


integer 


0 


Specifies the layer of the object. 
Layers are imaged in increasing 
order. This is to allow the 
specification of the order in which 
overlapping areas are printed. 


line-cap: 


yes 


butt, round, 
square 


butt 


Specifies the cap style of the line. 


line-dasb: 


yes 


’(length ...) 

I 


’(Opt) 


Specifies the pattern for the line. 
Lengths are interpreted as a 
sequence of dashes and gaps. 


line-tbickness: 


yes 


length 


Ipt 




line-repeat: 


yes 


integer>0 


1 


Specifies a number of parallel lines 
to be generated. 
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Table 7-1 (cont.). Common Characteristics 



Characteristic 


Inh 


Values 


Default 


Description 


line-sep: 


yes 


length 


Ipt 


Specifies the separation between the 
lines repeated due to a 
line-repeat : > 1. 


length: 


no 


length 


context 




display?: 


no 


boolean 


#f 


Specifies whether the object is 
displayed or inline. 


position-point- 

shift: 


yes 


length-spec 


Opt 


Specifies an elevation of the position 
point in the progression direction. 


display- 

alignment: 


yes 


start, center, end, 
inside, outside 


start 


Specifies the alignment in the 
writing-mode direction. 


position-point-x: 


no 


length-spec 


0 


Specifies the x-coordinate of the 
position point in the coordinate 
system. 


position-point-y: 


no 


length-spec 


0 


Specifies the y-coordinate of the 
position point in the coordinate 
system. 


escapement- 

direction: 


no 


top-to-bottom, 

left-to-right, 

bottom-to-top, 

right-to-left 


writing- 

mode: 





7.3.1. 1. Display Spaces 

Display-spaces are used to describe the desired separation between areas, as has already 
been explained in Section 7.2.17. More concretely, display- spaces are used to separate 
displayed areas. Objects of type display-space are used in the space-before : and 
space-after : common characteristics. There are two procedures that operate on 
objects of type display-space. 

display-space? 



(display-space? ob j ) 



Returns #t when obj is an object of type display-space. 

display-space 



(display-space length-spec #!key min: max: conditional?: priority:) 
Returns an object of type display-space. 
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• 1 eng th- spec is the nominal size of the space 

• min : max: are length-specs that specify the minimum and maximum sizes of 
the space. By default their value is length- spec 

• priori ty: is an integer used to assign a priority to the space, or the symbol 
force. By default its value is 0. When two display-spaces are adjacent, the one 
with lesser priority is ignored. If they have the same priority, the one with lesser 
size is subsumed by the other one. Otherwise, a display-space is formed taking 
the smallest max: and the largest min:. A value of force is larger than any 
other priority. Two adjacent forced display-spaces are added. 

• conditional ? : is a boolean value. By default its value is #t. It specifies 
whether the space is conditional. A conditional space is discarded when it starts 
an area. It permits display-spaces to disappear in column or page breaks. 

Example 7-35. display-space 

(display-space 12pt min: lOpt max: 14pt 
priority: 'force conditional: #f) 

7.3.1. 2. Length Specification 

Objects of type length-spec specify lengths as linear combinations of other lengths that 
may not be currently known. Whenever a length-spec is required, a length (a quantity 
of dimension 1) may always be used. 

display-size 



(display-size) 



This procedure may be used only in a characteristic of a displayed object, and 
returns a length-spec with its display-size. 

This procedure is the only one capable of generating objects of type length-spec 
from scratch. The rest of procedures below are used to combine length- specs into 
length- specs. 



+ 



(+ length-spec . . . ) 

See Also: +. 



(- length-spec . . . ) 



See Also: -. 
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{* length-spec k) 
(* k length-spec) 

See Also: *. 



/ 



(/ length-spec k) 

(/ k length-spec) 

See Also: /. 

7.3.2. The Simple-page-sequence Flow Object 

Use of this flow object class requires the simple-page feature. This flow object class 
must always be the root of the flow object tree, although a document may contain 
multiple simple-page-sequences. 

Table 7-2. Ports of the Simple-page-sequence Flow Object 



Port 


Objects 


#f 


D 



Table 7-3. Uncommon Characteristics of the Simple-page-sequence Flow Object 



Characteristic 


Inh 


Default 


Values 


Description 


page-width 


yes 


System 

dependent. 


length 


Specifies the total width. 


page-height 


yes 


System 

dependent. 


length 


Specifies the total height. 


left-margin 


yes 


Opt 


length 




right-margin 


yes 


Opt 


length 




top-margin 


yes 


Opt 


length 


The header is within the top 
margin. 


bottom-margin 


yes 


Opt 


length 


The footer is within the bottom 
margin. 


header-margin 


yes 


opt 


length 


Specifies the distance from the 
top of the page to the placement 
path for the header line. 
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Table 7-3 (cont.). Uncommon Characteristics of the Simple-page-sequence Flow Object 



Characteristic 


Inh 


Default 


Values 


Description 


footer-margin 


yes 


Opt 


length 


Specifies the distance from the 
bottom of the page to the 
placement path for the footer 
line. 


left-header 


no 


empty-sosofo 


unlabeled sosofo 


Specifies a header aligned with 
the left margin. 


center-header 


no 


empty-sosofo 


unlabeled sosofo 


Specifies a header centered 
between the margins. 


right-header 


no 


empty-sosofo 


unlabeled sosofo 


Specifies a header aligned with 
the right margin. 


left-footer 


no 


empty-sosofo 


unlabeled sosofo 


Specifies a footer aligned with 
the left margin. 


center-footer 


no 


empty-sosofo 


unlabeled sosofo 


Specifies a footer centered 
between the margins. 


right-footer 


no 


empty-sosofo 


unlabeled sosofo 


Specifies a footer aligned with 
the right margin. 



When formatted, this flow object class generates a sequence of pages that are filled from 
top to bottom. This flow object class is intended for the cases where complex formatting 
capabilities aren’t needed, allowing only a constant page layout with fixed single line 
headers and footers. A document may contain several objects of this class in sequence, 
allowing each chapter to insert its own header and footer. Each page is represented 
by a page area when it is formatted, whose width will be equal to page-width: - 
(left-margin : + right -margin 

Table 7-4. Common Characteristics of the Simple-page-sequence Flow Object 



Characteristic 


Description 


writing-mode 


Specifies the writing-mode of the header and footer lines. 



There are two procedures that can be used in the context of a 
simple-page- sequence flow object to generate page numbers. 



page-number-sosofo 



(page-number- sosofo) 



Returns the page number of the first page containing the object being formatted. 

Example 7-36. page-number-sosofo 

(root 

(make simple-page-sequence 
(make paragraph 

(literal "This page is;") 

(page-number-sosofo) ) 
center-footer: (page-number-sosofo) ) ) 
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current-node-page-number-sosofo 

(current-node-page-number-sosofo) 

Returns the page number of the primary flow object of the current node. This is 
intended to handle cross references in conjunction with the process-element-with- 
id procedure. It is very useful for the generation of indexes with page number 
references. 

Example 7-37. current-node-page-number-sosofo 



(element reference 
(make paragraph 

(process -children) 

(literal "on page") 

(wi th-mode pagenum 

(process -element -with- id 

(attribute-string "IDREF"))))) 
(mode pagenum 
(default 

(current-node-page-number-sosof o) ) ) 

Figure 7-7. Page Numbering 
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Figure 7-8. Diagram of the Simple-page-sequence Flow Object 
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7.3.3. The Page-sequence and 
Column-set-sequence Flow Objects 

Use of all the classes and procedures in this section require the page feature. 



7.3.3.1. The Page-sequence Flow Object 

The page- sequence flow object class is the class that permits the most complex 
formatting capabilities. As opposed to the simple -page -sequence class which 
generates a sequence of pages all with the same structure, the page-sequence allows 
the programmer to define the structure the pages will have by means of page models, 
creating sequences of pages with different layouts. 

Table 7-5. Ports of the Page-sequence Flow Object 



Port 


Objects 


specified in 
page-models 


D 
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Table 7-6. Uncommon Characteristics of the Page-sequence Flow Object 



Characteristic 


inh 


Vaiues 


Default 


Description 


initial-page- 

models 


yes 


’(page-model 

...) 


empty list 


Specifies the page-models to be used for 
the initial pages. There should be one 
page model for each initial page. 


repeat-page- 

models 


yes 


’(page-model 

...) 


empty list 


Specifies the page-models to be used for 
the pages after the initial pages. These 
page models form a repeating sequence. 
For example, if the list contained two 
page models, these models would be 
used for alternating pages. 


force-last-page 


yes 


#f, front, 
back 


#f 


Forces a type for the last page of the 
sequence. If needed, a blank page will 
be generated using 
blank-back-page -model ;. 


force-first-page 


yes 


#f, front, 
back 


#f 


Forces a type for the first page of the 
sequence. If needed, a blank page will 
be generated using 
blank- front-page-model. 


first-page-type 


yes 


#f, front, 
back, parent 


parent 


Specifies the type of the first page. It 
doesn’t cause the generation of blank 
pages; it only informs that this page will 
be of the specified type when printed or 
bound. It is used to determine which 
pairs of pages are spreads. 


blank-back-page- 

model 


yes 


page-model 


#f 


Specifies the page model to be used for a 
blank back page. This is only used if the 
final page is a back page that was 
required by a force-last-page : or 
force- first-page : value. 


blank-front-page- 

model 


yes 


page-model 


#f 


Specifies the page model to be used for a 
blank front page. This is only used if the 
final page is a front page that was 
required by a force-last-page : or 
force- first-page : value. 


justify-spread? 


yes 


boolean 


#f 


Specifies whether the lower part of each 
page in a spread is justified. Potential 
spreads are those pages that, once 
bound, lie side by side upon opening the 
book, forming a space of a double page. 
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Table 7-6 (cont.). Uncommon Characteristics of the Page-sequence Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


page-category 


yes 


object for 
which the 
equal? 
procedure is 
defined 


Undefined. 


Specifies the category of the pages of 
this flow object. It is used for page 
numbering purposes with 
category-page-number procedure. 


binding-edge 


yes 


left, right, 
top, bottom 


left 


Specifies the side where the binding will 
be. It affects whether a page side is 
considered in the inside or outside. 



Example 7-38. Construction of a Page-sequence Flow Object 

(make page-sequence 

repeat-page-models: ' (left -page -model right-page-model)) 

Characteristics whose data type is page-model expect, as a value, the specification of 
a page model. Page models specify the structure of a page, defining a set of page ar- 
eas that can in turn be divided into columns using column -set -sequence flow 
objects. 

Each page-model has a specified length and width, that define a coordinate space, inside 
which page-regions can be created as rectangles, each with its own height and width. It 
is in these page-regions that the content of the document will be placed. 

More than one region may be specified within a page. Each region may specify several 
ports with the flow procedure, each directed to the same region (they are more or less 
aliases; it doesn’t matter which port is used). In the event of a port occurring in more 
than one region, regions will be filled in the order in which they are defined in the page 
model. 

Example 7-39. Page-sequence 

(element chapter 

(make page-sequence 

force-first-page: 'front 

initial-page-models: ' (chapter-f irst-page) 
repeat-page-models: ' (verso-chapter-page 

recto -chapter-page) 

blank-back-page-model: verso-chapter-page) ) 
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define-page-model 



( def ine-page-model page -model -name 
(width length) ; required 
(height length) ;required 
(filling-direction ;optional 

' lef t-to-right | 'right-to-left | ' top-to-bottom) 

(decorate (decoration-area . . . ) ) ;optional 
( region ;at least one region required 
(x-origin length) .required 
(y-origin length) ; required 
(width length) ;required 
(height length) .’required 
(header .’optional 

(height length) ; optional 
(width length) ; optional 
(filling-direction . . . ); optional 
(contents -alignment .’optional 

'start I 'end | 'center | 'justify) 

(generate unlabeled-sosofo ) ) ’.required 
.’the unlabeled-sosofo is a generated-object, see Section 7.33.4 
(footer .optional 

(height length) .’optional 
(width length) .optional 
(filling-direction . . . ); optional 
(contents-alignment . . . ); optional 
(generate unlabeled-sosofo) ) .’required 
(flow port . . .) ; optional 
(filling-direction . . .) -.optional 
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;if page-region has no filling-direction, it inherits the 
;filling -direction of its containing page-model It is an 
;error if neither the region nor its containing page-model 
;defines the filling direction. 

(decorate (decoration-area ...)))) ;zero or more 



page-model? 

(page-model? ob j ) 

Returns #t when obj is a page- model. 

Figure 7-9. Page model 



mdth 




Note: There is a lack of clearness in the explanations of the standard concerning page regions. 
At some point it is said that page-models may overlap, but in all graphic examples page-regions 
are drawn disjunct, with boundaries between them, what suggests that they are disjunct and don’t 
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overlap, although the presence of the layer : characteristic is only reasonable if models overlap. 
It is expected that future extensions clarify more these aspects. 

Figure 7-10. Spread 
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7.3.S.2. The Column-set-sequence Flow Object 

Columns may be used to divide page-areas or other columns, resulting in a hierarchy 
of areas within areas. 

Table 7-7. Ports of the Column-set-sequence Flow Object 



Port 


Objects 


specified in 
column-set-models 


D 



Table 7-8. Uncommon Characteristics of the Column-set-sequence Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


column-set-model- 

model-map 


yes 


’ ((page-model 
colunm-set-model) ...) 


empty list 


Specifies a list of 
associations between 
page-models and 
colunm-set-models. 


column-set-model 


yes 


#f, column- set-model 


#f 


Specifies a default 
colunm-set-model for 
those page-models 
without association. 
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Table 7-9. Common Characteristics of the Column-set-sequence Flow Object 



Characteristic 


position-preference 


span 


span-weak? 


space-before 


space-after 


keep-with-previous? 


keep-with-next? 


break-before 


break-after 


keep 


may-violate-keep-before? 


may-violate-keep-after? 



Example 7-40. Column-set-sequence 

(element chapter 

(make page-sequence 

repeat-page-models: ' (chapter-page) 

(make column-set-sequence 

column- set -model : double -columns) ) ) 



define-column-set-model 



(define-column-set-model col set -name 

(fill- out boolean) ; Optional. When #t each columnset is filled 

fin the filling-direction to the maximum size allowed by container area. 

(tie ;Zero or more. Two or more subsets that are tied together 
;may be used, for example, for sidenotes. 

(column-subset ...) 

(column-subset . . . ) ) 

(filling-direction ;Optional. 

' lef t-to-right | 'right-to-left | ' top-to-bottom) 

(width length) ;Optional. 

(height length) ;Optional. 

; If width or height are specified, size is fixed. Otherwise size increases with content. 
(decorate (decoration-area ...)) ;Zeroormore. 

(column-subset ;Zeroormore. 

(flow port ;Required. 

top-float 1 body-text | bottom-float | foot-note 
. . . ) ; Several zones accepted per port. 

( top-f loat-space-below display-space) .‘Optional. 

(bottom-f loat-space-above display-space) ;Optional. 

(balance? boolean) ;Optional. Allocate free space evenly among columns. 
(justify? boolean) ;Optional. Column is justified only when filled out. 

( justify-limit number) ; Optional. Between 0 and 100. 

; Justify when free space is less than the percentage. 
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( justify-last-limit number) ; Optional. Between 0 and 100. 

; Justify when free space of last is less than the percentage. 
(length-deviation length) ; Optional. Must be positive. 

; Columns may differ this maximum when justifying or balancing. 

( length-decrease-order '.Optional. 

forward | backward | #f) 

(align-lines? boolean)) .Optional. Distribute free space 

;to keep lines in different columns aligned. 

(column ;At least one column. Columns may not overlap. 

(width length) ; If filling-direction top-to-bottom. 

(x-origin length) ;If filling-direction top-to-bottom. 

( height 1 engt h ) ; If filling-direction right-to-left or left-to-right. 

(y-origin length) ; If filling-direction right-to-left or left-to-right. 

( footnote-separator .’Optional. To be generated when footnotes present. 

(height length) .'Optional. 

(width length) ;Optional. 

(filling- direct ion ; Optional. 

'left-to-right | 'right-to-left | 'top-to-bottom) 

(contents -alignment .Optional. 

'start I 'end | 'center | 'justify) 

(generate unlabeled-sosof o ) ) .’Required. A generated-object, see Section 7. 3. 3.4. 
(header '.Optional. 

(height length) ; Optional. 

(width length) .Optional. 

(filling-direction . . . ) ;Optional. 

(contents-alignment ...) .Optional. 

(generate unlabeled-sosof o) ) .'Required. 

(footer ; Optional. 

(height length) ; Optional. 

(width length) .’Optional. 

(filling-direction . . . ) ;Optional. 

(contents-alignment ...) '.Optional. 

(generate unlabeled-sosof o) ) ) ) .'Required. 

The above procedure returns an object of type column-set-model that specifies the 
possible hierarchy of areas. 

A layout order is defined as a partial ordering of the areas in a column- set area. It 
is partial because no layout order is defined between columns in different subsets. 
The main utility of the layout order is for filling the area containers. If two areas 
come from the same stream, they are placed so that their layout order follows their 
order in the stream. 

Example 7-41. define-column-set-model 

(define -column- set -model double-columns 
(column- subset 
(column 

(x-origin Opt) 

(width column-width) ) 

(column 

(x-origin (+ column-width column-separation)) 

(width column-width) ) 

( flow 

(#f body- text) 

(graphics top-float bottom-float) 

(foot footnote)))) 
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column-set-model? 

(column-set-model? ob j ) 

Returns #t when obj is a column-set-model. 

A column- set- sequence may also be associated with page-models with column- set- 
model-map:. 

Example 7-42. column-set-model-map: 

repeat-page-models; '(right left) 

CO lumn- set -model -map : '((right rightcols) (left leftcols) ) 

Figure 7-11. Diagram of the Column-set-sequence Flow Object 
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Figure 7-12. Column-set-sequence Configurations 
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Flow objects may span more than one column. One column subset is spannable unless 
the geometric placement does not follow the declaration order. In the three configura- 
tions above, in column- set-model 1 column subsets are both spannable, because con- 
secutive columns are also geometrically consecutive. In column-set-model 2, column- 
subset 1 is not spannable, because column 3 is between two other consecutive columns, 
1 and 2, while column-subset 2 is spannable. The standard seems to allow a definition 
equivalent to column- set-model 3, with overlapping column-subsets, in which case, 
column-subset 1 is spannable, because columns in the same column-subset are geo- 
metrically sequential, although there is a column from another column-subset between 
columns 1 and 2, and the same happens with column-subset 2 which is also spannable 
although intermixed with column-subset I . 

An area that spans more than one column may span either weakly or strongly depending 
on the value of span -weak ? : . 

When an area spans strongly it follows in the layout order any areas that: 
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• are in the same column-subset as the area 

• precede the area geometrically in the filling direction 

• have a span that is completely included in the span of the area, and 

• are labelled with the same zone as the area 

When an area spans weakly it follows in the layout order exactly those areas that it 
would follow if it occupied only the first of the columns that it spans. 

Columns are divided in three main areas, top-float, bottom-float and body. There is a 
fourth area, footnote, which is part of bottom-float zone. 

Figure 7-13. Column zones 

Page 




column column 

Two column subsets may be tied so that flow objects may be synchronized between 
both (for example, side-notes) by means of synchronization procedures, see Section 
7.3.3.3. 



7.3.3.3. Synchronization of Fiow Objects 

Synchronization facilities require the page feature. 
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Sometimes the position of an object is constrained relative to the position of another 
object. Footnotes usually appear at the bottom of the page where the reference occurs. 
Sidelines run a length parallel to the modified text. These constraints are specified with 
syncronization sets where the constrained flow objects have their positions related in 
some way that may be specified. 

There are two procedures that can be used to create synchronization sets. 

sync 



(sync sosofo^ sosofo^ # ! key type: min: max:) 



Synchronizes the first members of sosofo^ and sosofo^, creating a vertical 
synchronization between objects, type : specifies three kinds of synchroniza- 
tion: page, spread and column; it defaults to page, min: and max: specify the 
acceptable separation between the synchronized objects in terms of a number of 
areas as specified by type : . 

Example 7-43. Synchronization of Footnotes 

(element note 
(sync 

(make sequence 

font-size: (* (inherited-font-size) super-size-factor) 

alignment-point-offset: (- (* (inherited-font-size) 

elevation-factor) ) 

(literal (format -number (note-number) "1"))) 

(make paragraph 
label : ' foot 

font-size: foot-fonts-size 

(literal ( format -number (note-number) "1")) 

(literal " . - " ) 

(process-children) ) 
type: 'page)) 

(define (note-number) 

(list-ref (element-momber-list '("Chapter" "Note")) 1)) 

side-sync 



(side-sync list) 



Synchronizes horizontally the first members of each of the sosofos of list. 



7.3.S.4. Generation of Text Dependent on the Layout 

Layout-driven generated text procedures require the page feature. 

There are times when the text to be formatted is not known until the formatting of other 
parts has been realized. In the generation of a table of contents, it is possible to extract 
all section titles from the content of the document, and to number each section using 
the language procedures, but the pages where these sections lie will only be known 
once the formatting has been performed. In the case of a dictionary, the guide words 
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at the top of each page will only be known when each page is formatted and the first 
and last entries of each page are known. Each element of this type of generated text is 
represented by an indirect flow object. Indirect flow objects are not created by the same 
mechanisms as normal flow objects. Instead, the following procedures are used. 

generated-object? 



(generated-object? ob j ) 

Returns # t when obj is a generated-object 

7.3.3.4.I. General Indirect Sosofos 

Use of procedures in this section require the general-indirect feature. 

general-indirect-sosofo 



(general-indirect-sosofo procedure generated-object) 



Return a sosofo that contains the single indirect flow object resulting from apply- 
ing the procedure to the list of objects specified by generated-object. 

Example 7-44. Generation of a Reference to a Graphic that is on Another 
Page 

(element xref 

(map-constructor 

(lambda () (process-xref (current-node))) 

(element (attribute-string "REFID")))) 

(define (process-xref xref-node) 

(if (match-element? 'chapter (current-node)) 

(with-mode xref (process-node-list (current-node))) 

( sosof o-append 
(literal 
"Figure" 

( format -number ( element -number ) "1")) 

(general-indirect-sosofo 
page-ref -if -different 
(page-number 

f irst-area-of -node : (current -node) ) 

(page-number f irst-area-of-node ; xref-node))))) 

(define (page-ref-if-dif f erent figure-page current-page) 

(if (equal? figure-page current -page) 

(empty-sosofo) 

(literal 
" , page " 

(format -number figure-page "1")))) 
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7.3.S.4.2. Asis indirect sosofos 
asis-indirect-sosofo 

(asis-indirect-sosof o reference-value) 

This procedure is used with reference values. The standard defines a series 
of procedures that define and use reference values. They are primarily used 
in the generate procedures inside header, footer, footnote-separator, etc. of 
page -sequence, for which reason they will be explained here. 

Reference value generated objects in asis-indirect-sosofo procedures are generated by 
the procedures below. 

declare-reference-value-type 



(declare-reference- value -type identifier) 

This procedure declares identifier as a reference value type. 

Example 7-45. declare-reference-value-type 

(declare-reference-value-type 'name) 

The declared reference value type may then be used in make expressions using 
identifier as a keyword specifying the value for the reference value type. A 
flow object may have a number of reference values associated with it. 

Example 7-46. reference- value- type as keyword 

(element p 

(make paragraph 
name : 'x) ) 

Reference values give access by value to positions in the flow object tree using a 
page-sequence generate procedure or in a decoration-area procedure. 

first-area-reference-value 



(first-area-reference-value symbol #!key default: inherit:) 

Traverses the flow object tree in preorder (first the parent, then the children) and 
returns the first sosofo that assigns a value to the specified reference value type. If 
no sosofo is found, it returns default : . 

This procedure may be used inside a generate procedure of page- sequence 
or coluinn-set-sequence, or in the construction of a decoration area. The 
context where it is used determines the list of associated areas to which it applies. 
In a decoration area, it operates just on the decorated £irea. In a header, footer or 
footnote- separator, it operates on the areas in the same column-set area container 
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and that are in the body-text zone and that overlap the column, or the areas in the 
same page-region area container as the generated area. 

last-area-reference-value 



(last-area-reference-value symbol # ! key default: inherit:) 



Traverses the flow object tree in preorder (first the parent, then the children) and 
returns the last sosofo that assigns a value to the specified reference value type. 

last-preceding-area-reference-value 



(last-preceding-area-reference-value symbol # ! key default:) 

Traverses the flow object tree in preorder (first the parent, then the children) and 
returns the last previous sosofo that assigns a value to the specified reference value 
type. It may be used in the defaul t : argument of first-area-reference-value. 

all-area-reference-values 

(all-area-reference-values symbol # ! key unique: inherit:) 

Traverses the flow object in preorder (first the parent, then the children) and returns 
all flow objects that assign a value to the reference value type symbol. When 
unique ; #t, duplicates are discarded. 

Example 7-47. Insertion of a Guide Word in a Dictionary 

(declare-reference-value-type ' lema) 

(element encicl 

(make page-sequence 

repeat-page-models: ' (body-pages) 

(make column-set-sequence 

column-set-model-map: ' ( (body-pages body-columns) ) ) ) ) 

(def ine-page-model body-pages 
(region 

(x-origin . . . ) 

(y-origin . . . ) 

(width . . . ) 

(height . . . ) 

( footer 

(generate (number-indirect-sosofo (page-number) ) ) 
(contents-alignment 'center))) 

(width . . . ) 

(height . . . ) ) 

(def ine- column- set -model body-columns 
(column-subset 
(column 
(header 
(generate 

(asis-indirect-sosof o 

(first-area-reference-value 'lema) ) ) 

(contents-alignment ' start) ) ) ) ) 
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(define 

(column- subset 
(column 
(header 
(generate 

(asis-indirect-sosofo 

(last-area-reference 'lema))) 
(contents-alignment 'end)))) 
(element lema 

(make sequence 

font-weight: 'bold 
lema: (make paragraph 

font-weight : ' bold) ) ) ) 

7.3.3.4.S. Number indirect sosofos 
number-indirect-sosofo 



(number-indirect-sosofo integer # ! key format: add: multiple:) 

Returns an indirect sofofo representing integer. It is used for inserting nu- 
meric indirect values, integer is generated by one of the procedures that gener- 
ate numeric values from the layout, see below for explanations, format : spec- 
ifies conversion of the number as specified in format-number, add: increments 
integer, defaulting to 0. mul tiple: specifies only to return numbers that are 
multiple of this value, defaulting to 1, otherwise an empty string is returned, add : 
is performed before testing for multiplicity. 

The procedures below are intended for the generation of numbers that depend on the 
formatting. The procedures solve, concretely, the generation of page numbers, column 
numbers, footnote numbers and line numbers. 

Although a column is not an area, for numbering purposes it is treated as an area. 

Generation of page numbers. 

page-number 



(page-number ) 

Generates the number of pages before or the same as the first area resulting from 
the primary flow object of the current node if there is a current node. If it is used 
inside a generate procedure it generates the number of pages before or equal the 
generated area. In a decorate procedure it generates the number of pages before 
or equal the decoration area. 

(page-number #!key first-area-of-node:) 

Generates the number of pages before or the same as the first area resulting from 
the primary flow object of node first-area-of-node : . 

(page-number #!key last-area-of-node:) 
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Generates the number of pages before or the same as the last area resulting from 
the primary flow object of node first-area-of-node : . 

category-page-number 



(category-page-number #!key first-area-of-node: last-area-of-node : ) 

Generates the number of pages before or the same as the reference area that have 
the same category as the page that is or contains the reference area. It behaves in 
a similar way as page-number procedure. 

See Also: page-number. 

page-number-in-node 



(page-number- in-node snl) 

Generates the number of pages that are before or contain the first of the areas 
generated by the indirect- sosofo in which the generated object is used and contains 
areas from the flow object that corresponds to snl. 

This procedure could be used within a table header or footer. Perhaps this could 
be used to control the generation of middle titles in table breaks. 

total-node-page-numbers 



( total -node-page-numbers snl) 



Generates the total number of pages that contain an area from the primary flow 
object associated with snl. 

Generation of column numbers. 

column-number 



(column-number # ! key first-area-of-node: last-area-of-node:) 

Generates the number of columns in the same column-subset as the reference area 
that is before or the same as the reference area. It behaves in a similar way as 
page-number procedure. 

See Also: page-number. 

Generation of footnote numbers. 

footnote-number 



(footnote-number symbol # ! key first-area-of-node: last-area-of-node:) 

Generates the number of footnote areas that are before or the same as the reference 
area and are descendants of the nearest ancestor of type symbol (page, page- 
region, column). For this purpose, a footnote area is an area which is the first in 
the sequence of areas produced from a flow object whose stream is directed into 
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the footnote zone of a column-set-sequence flow object. It behaves in a similar 
way as page-number procedure. 

See Also: page-number. 

Generation of linw numbers. 

line-number 



(line-number symbol # ! key f irst-area-of-node : last-area-of-node ; ) 

Generates the number of line areas that are before or the same as the reference area 
and are descendants of the nearest ancestor of type symbol (page, page-region, 
column, paragraph). Line areas from paragraphs with numbered- lines ? : # f 
are not counted. 

Example 7-48. Creation of a Table of Contents 

(element (doc title) 

( sosof o-append 

(make page-sequence 

initial-page-models: ' (chapter-fist-page) 

(make paragraph 
font-size: 28pt 
line-spacing: 32pt 
quadding: 'center)) 

( table-of-contents) ) ) 

(define (table-of-contents) 

(make page-sequence 

force-first-page: 'front 

repeat-page-models: ' (chapter-first-page) 

(make sequence 
(make paragraph 

use: chapter-title-style 
(literal "Table of Contents")) 

(wi th-mode toe 

(process-node- list 
(q-element 'title 

(tree-root (current-node) ))))))) 



(mode toe 

(element title 
(make paragraph 
(literal 

( format-number 

(ancestor-child-number "CHAPTER" ) 

" 1 ")) 

(if (have-ancestor? "SECTION") 

(literal 

( format -number 

(ancestor-child-number " SECTION" ) 
" 1 ") ) 

(empty-sosof o) ) 

(literal " . -" ) 

(process -children) 

(make leader (literal ".")) 
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(number-indirect-sosof o (page -number) ) ) ) ) 

This example contains the leader flow object which, in this case, generates a line of 
dots between the title and the page number. 



7.3.3.S. Decoration Areas 

Decoration areas procedures require the page feature. 

An area container may be “decorated” with one or more areas called decoration areas. 
Decoration areas do not affect how parent areas treat the decorated area; in particular, 
they do not change the width or height of the decorated area. 

decoration-area 



(decoration-area sosofo # ! key placement-point-x : 
placement-point -y: placement-direction: ) 

The position point of the inlined sosofo will be placed on the coordinates 
defined by (placement-point-x, placement -point-y) with a 
escapement-direction of placement -direct ion. 

decorated-area-width 



(decorated-area -width) 



Returns a length-spec specifying the width of the area to be decorated. 
It may be used in the specification of placement-point-x : and 
placement-point-y : in decoration-area. 

decorated-area-height 



( decora ted-area -height ) 

Returns a length-spec specifying the height of the area to be decorated. 
It may be used in the specification of placement-point-x : and 
pi acemen t -po int-y: in decoration-area . 
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Figure 7-14. Diagram of the Decoration-area Flow Object 



decorated area 




7.3.4. Paragraph, Paragraph-break and 
Alignment-point 

7.3.4.1. The Paragraph Flow Object 

The paragraph flow object class represents a paragraph, and is always displayed. 

Table 7-10. Ports of the Paragraph Flow Object 



Port 


Objects 


#f 


D/I 



Table 7-11. Uncommon Characteristics of the Paragraph Flow Object 



Characteristic 


inh 


Values 


Default 


Description 


lines 


yes 


wrap, asis, 
asis-wrap, 
asis-truncate, 
none 


wrap 


Specifies how to break the 
paragraph’s content into lines. 


asis-truncate-char 


yes 


#f, char object 


#f 


Specifies the glyph to be inserted at 
the end of truncated lines when 
lines: ' asis-truncate. 
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Table 7-11 (cont.). Uncommon Characteristics of the Paragraph Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


asis-wrap-char 


yes 


#f, char object 


#f 


Specifies the glyph to be inserted at 
the end of a line broken after a 
character with 
record- end ? : #f when 
lines: ' asis-wrap. 


asis-wrap-indent 


yes 


length- spec 


#f 


Specifies the indent to be added to 
the start-indent when lines : 

' asis-wrap for a line following a 
break after a character with 
record- end? : #f. 


first-line-align 


yes 


#f, #t, character 


#f 


Specifies whether the first line 
should be aligned using an 
alignment point. When not # f , 
quadding : and 
last-line-quadding : are 
ignored for the first line. The first 
line will be aligned using an 
alignment point placed on the first 
character in the line matching the 
character specified, or, when #t, on 
the position of the first 
alignment-point in the line. 


alignment-point- 

offset 


yes 


#f, 0..100 


50 


Specifies the placement of an 
implicit alignment -point in 
the position equivalent to the 
percentage of line length. 


ignore-record- 

end? 


yes 


boolean 


#f 


Specifies whether record-ends are 
ignored. 


expand-tabs? 


yes 


#f,n>0 


8 


Specifies the tab interval. Each 
char ac ter with inpu t - tab ? : 
#t will add this number of spaces. 


line-spacing 


yes 


length- spec 


12pt 


Specifies the normal spacing 
between placement paths of lines. 


line-spacing- 

priority 


yes 


integer, force 


0 


Specifies the priority of conditional 
spaces. 


min-pre-line- 

spacing 


yes 


length- spec, #f 


#f 

i 


Specifies the minimum size of the 
line before the placement path. #f 
means the value is determined from 
the font. 


min-post-line- 

spacing 


yes 


length-spec, #f 


#f 


Specifies the minimum size of the 
line after the placement path. 
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Table 7-11 (cont.). Uncommon Chaiacteristics of the Paragraph Flow Object 



Characteristic 


inh 


Vaiues 


Defauit 


Description 


min-leading 


yes 


length-spec, #f 


#f 


Specifies the minimum space 
between the lines. It also prevents 
overlapping lines. 


first-line- start- 
indent 


yes 


length-spec 


Opt 


Specifies an indent to add at the start 
of the first line. It may be negative. 


last-line-end- 

indent 


yes 


length-spec 


Opt 


Specifies an indent to add at the end 
of the last line. It may be negative. 


hyphenation-char 


yes 


char 


#\_ 


Specifies the glyph inserted when 
hyphenation is performed. 


hyphenation- 

ladder-count 


yes 


#f,n>0 


#f 


Specifies a maximum number of 
consecutive lines hyphenated. 


hyphenation- 

remain-char- 

count 


yes 


n>0 


2 


Specifies the minimum allowed 
number of characters in the word 
before hyphenation. 


hyphenation- 

push-char-count 


yes 


n>0 


2 


Specifies the minimum allowed 
number of characters in the word 
after hyphenation. 


hyphenation-keep 


yes 


spread, page, 
colunm, #f 


#f 


Specifies the single space where 
both parts of a hyphenated word 
must lie. 


hyphenation- 

exceptions 


yes 


’(string ...) 


empty list 


Specifies a list of hyphenation 
exceptions. Each string is a word 
containing hyphen characters, #\-, 
indicating where hyphenation is 
allowed. If a word to be hyphenated 
occurs in the list, it may only be 
hyphenated in the specified points. 


line-breaking- 

method 


yes 


string, #f 


#f 


Specifies the public identifier of the 
breaking method desired for this 
paragraph. 


line-composition- 

method 


yes 


string, #f 


#f 


Specifies the public identifier of the 
composition method desired for this 
paragraph. 


implicit-bidi- 

method 


yes 


string, #f 


#f 


Specifies the public identifier of the 
method thar determines the 
directionality of the content of the 
paragraph. 
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Table 7-11 (cont.). Uncommon Characteristics of the Paragraph Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


glyph-alignment- 

mode 


yes 


base, center, top, 
bottom, font 


font 


Specifies the alignment mode for 
glyphs. 


numbered-lines? 


yes 


boolean 


#t 


Specifles whether the lines of this 
paragraph count for line numbering. 


line-number 


yes 


#f, unlabelled 
sosofo containing 
only inline flow 
objects 


#f 


Specifies an attachment area for 
each line, sosofo may include the 
line-number procedure for the 
purpose of line numbering. Line 
numbers are usually placed next to 
the line, but with line- field it 
can be altered. 


line-number- side 


yes 


start, end, 

spread-inside, 

spread-outside, 

page-inside, 

page-outside 


?? 


Specifies the side of the line for 
attaching line numbers, 
spread-inside and spread-outside 
require a 

column- set -sequence 
ancestor, while page-inside and 
page-outside require a 
page -sequence ancestor. 


line-number-sep 


yes 


length- spec 


?? 


Specifies the separation between the 
lines and the line numbers. 


quadding 


yes 


start, end, 

spread-inside, 

spread-outside, 

page-inside, 

page-outside, 

center, justify 


start 


Specifies the alignment of lines 
other than the last. 


last-line- 

quadding 


yes 


relative, start, 
end, 

spread-inside, 
spread-outside, 
page-inside, 
page-outside, 
center, justify 


relative 


Specifies the alignment of the last 
line. 


last-line-justify- 

limit 


yes 


length- spec 


0 


Specifies the maximum amount of 
free space in the last line that causes 
it to be justified rather than aligned 
as specified by 
last- line- quadding : . 


justify-glyph- 

space-max-add 


yes 


length- spec 


Opt 


Specifies the maximum space that 
may be added between glyphs for 
justification. 
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Table 7-11 (cont.). Uncommon Characteristics of the Paragraph Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


justify-glyph- 

space-max- 

remove 


yes 


length-spec 


Opt 


Specifies the maximum space that 
may be removed between glyphs for 
justification. 


hanging-punct? 


yes 


boolean 


#f 


Specifies whether punctuation 
characters may hang into the margin 
or gutter. 


widow-count 


yes 


n>0 


2 


Specifies the minimum number of 
lines kept together at the beginning 
of an area. Thus no break is allowed 
between the last n lines of the 
paragraph. 


orphan-count 


yes 


n>0 


2 


Specifies the minimum number kept 
together at the end of an area. Thus 
no break is allowed between the first 
n lines of the paragraph. 



Table 7-12. Common Characteristics of the Paragraph Flow Object 



Characteristic 


Description 


font-family-name 


Applicable when glyph- alignment -mode : ’font. 


font-weight 


Applicable when glyph- alignment -mode : ’font. 


font-posture 


Applicable when glyph- alignment -mode : ’font. 


font-structure 


Applicable when glyph- alignment -mode : ’font. 


font-proportionate- width 


Applicable when glyph- alignment -mode : ’font. 


font-name 


Applicable when glyph-alignment-mode : ’font. 


font-size 


Applicable when glyph- alignment -mode : ’font. 


language 




country 




position-preference 




writing-mode 


This controls the orientation of the placement path of lines. 


start-indent 


This applies only to lines from the paragraph itself. 


end-indent 


This applies only to lines from the paragraph itself. 


span 




span-weak? 




space-before 




space-after 




keep- with-previous ? 
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Table 7-12 (cont). Common Characteristics of the Paragraph Flow Object 



Characteristic 


Description 


keep-with-next? 




break-before 




break-after 




keep 




may-violate-keep-before? 




may-violate-keep-after? 





Figure 7-15. Diagram of the Paragraph Flow Object 
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Figure 7-16. Line Spacing in the Paragraph Flow Object 
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Figure 7-17. Min-leading in the Paragraph Flow Object 
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Figure 7-19. Conditional Spaces 
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Figure 7-20. First Line Spacing 
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When a paragraph has alignment-point-offset : #f it will be externally 
aligned. It can only occur when the paragraph occurs inside a table-cell 
or an aligned- column. All externally aligned paragraphs will place their 
alignment-points along a line. 



7.3.4.2. The Paragraph-break Flow Object 

Paragraph -break flow objects are used to make paragraph flow objects repre- 
sent a sequence of paragraphs. It is recommended as an ultimate resource, when there 
is no other way of specifying the desired formatting. The sequence will be separated 
by a paragraph -break flow object, which is atomic and can only occur inside 
paragraph flow objects. 
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The characteristics specified in the paragraph-break flow object will affect the 
portion of the paragraph that follows the paragraph-break, until the next 
paragraph-break occurs. 

Table 7-13. Uncommon Characteristics of the Paragraph-break Flow Object 



Characteristic 


Description 


lines 




asis-truncate-char 




asis-wrap-char 




asis-wrap-indent 




first-line-align 




alignment-point-offset 




ignore-record-end? 




expand-tabs? 




line-spacing 




line-spacing-priority 




min-pre-line-spacing 




min-post-line- spacing 




min-leading 




first-line-start-indent 


Applies to the line after the paragraph-break. 


last-line-end-indent 


Applies to the line before a paragraph-break. 


hyphenation-char 




hyphenation-ladder-count 




hyphenation-remain-char-count 




hyphenation-push-char-count 




hyphenation-keep 




hyphenation-exceptions 




line-breaking-method 




line-composition-method 




implicit-bidi-method 




glyph-alignment-mode 




numbered-lines? 




line-number 




line-number-side 




line-number- sep 




quadding 




last-line-quadding 
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Table 7-13 (cont). Uncommon Characteristics of the Paragraph-break Flow Object 



Characteristic 


Description 


last-line-justify-limit 




justify-glyph-space-max-add 




justify-glyph-space-max-remove 




hanging-punct? 




widow-count 




orphan-count 





Table 7-14. Common Characteristics of paragraph-break 



Characteristic 


Description 


font-family-name 




font-weight 




font-posture 




font-structure 




font-proportionate-width 




font-name 




font-size 




language 




country 




position-preference 




writing-mode 


Specifies the orientation of the placement path of the lines. 


start-indent 




end-indent 




span 




span-weak? 




space-before 




space-after 




keep- with-previous ? 




keep-with-next? 




break-before 




break-after 




keep 




may- violate-keep-before ? 




may-violate-keep-after? 
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7.S.4.3. The Alignment-point Fiow Object 

Specifies an explicit alignment point for paragraph flow objects with 
first-line-align: #t. See Figure 7-15. Alignment-points are atomic and 
inlined. 



7.3.5. The Line-field Flow Object 

The line- field flow object class produces a single inline area with a length of 
field-width: , although the area grows to accommodate the contents. A line break 
can occur immediately before and after a line- field inside a paragraph. A line 
break is not allowed inside a line -fie Id. 

Table 7-15. Ports of the Line-field Flow Object 



Port 


Objects 


#f 


I 



Table 7-16. Uncommon Characteristics of the Line-field Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


field-width 


yes 


length-spec 


Opt 


Specifies the minimum width. 


field- align 


yes 


start, end, 
center 


start 


Specifies the alignment of the 
contents. 



Table 7-17. Common Characteristics of the Line-field Flow Object 



Characteristic 

writing-mode 

inhibit-line-break? 

break-before-priority 

break-after-priority 
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Example 7-49. Diagram of the Line-field Flow Object 
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7.3.6. The Side-by-side and Side-by-side-item Fiow 
Objects 

Use of the classes in this section require the side-by-side feature. 



7.3.6.I. The Side-by-side Fiow Object 

The side-by-side flow object class is a displayed flow object class. 

Table 7-18. Ports of the Side-by-side Flow Object 



Port 


Objects 


Description 


#f 


side-by-side-item 


Items are potentially aligned with each other in the 
placement direction. 



Table 7-19. Uncommon Characteristics of the Side-by-side Flow Object 



Characteristic 


inh 






Description 


side-by-side- 

overlap-control 


yes 


none, 

indent 


indent 


Determines the handling of overlapping 
side-by-side-items. 



Table 7-20. Common Characteristics of the Side-by-side Flow Object 



Characteristic 

position-preference 

space-before 

space-after 

keep-with-previous? 
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Table 7-20 (cont.). Common Charac teristics of the Side-by-side Flow Object 

Characteristic 

keep-with-next? 

break-before 

break-after 

keep 

may-violate-keep-before? 
may-violate-keep-after? 



7.3.6.2. The Side-by-side-item Fiow Object 

Side-by-side-items occur inside side-by-side flow objects, and are always 
displayed. Their display-size is the same as the containing side-by-side. 

Table 7-21. Ports of the Side-by-side-item Flow Object 



Port 


Objects 


#f 


D 



Table 7-22. Uncommon Characteristics of the Side-by-side-item Flow Object 



Characteristic 


Inh 


Vaiues 


Default 


Description 


side-by-side-pre- 

align 


yes 


start, initial, 
final, end 


initial 


Specifies the point used to align this 
item with the preceding one. 


side-by-side- 

post-align 


yes 


start, initial, 
final, end 


initial 


Specifies the point used to align this 
item with the following one. 



Each item aligns its side-by-side-pre-align : point with the 

side-by-side-post -align : point of the preceding one. 



If side-by-side-overlap-control : 'indent and start-indent : < 
(display-size) - end-indent : then it is positioned after the previous item in 
the placement direction. 

Any space-before : of the first area of an item, and any space-after : of the 
last area of an item are ignored. 

Table 7-23. Common Characteristics of side-by-side-item 



Characteristic 


Description 


start-indent 


Specifies whether adjacent side-by-side-items overlap when the containing 
side-by-side has side-by-side-overlap-control : 
'indent. 
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Table 7-23 (cont.). Common Characteristics of sidc-by-side-item 



Characteristic 


Description 


end-indent 


Specifies whether adjacent side-by-side-items overlap when the containing 
side-by-side has side-by-side- overlap- control : 
'indent. 



7.3.7. Classes for Formatting Tables 

Use of classes in this section require the table feature. 



7.3.7.1. The Table Flow Object 

A table flow object can only be displayed. Tables have two directions associated with 
them, a row-progression direction and a column-progression direction. The column- 
progression direction is specified by wri ting-mode : , and it causes a perpendicular 
row-progression direction, which corresponds with the placement direction of the table. 

Table 7-24. Ports of the Table Flow Object 



Port 


Objects 


Description 


#f 


all of class table-part only, or 
table-columns followed by table-rows 
and table-cells 


table-columns must occur before all 
other flow objects 



Table 7-25. Uncommon Characteristics of the Table Flow Object 



Characteristic 


inh 


Values 


Default 


Description 


table-width 


no 


#fif 

table-auto- width 
feature present, 
length- spec 
otherwise 


display-size - 
indents 


Specifies the size of the 
table in the 
column-progression 
direction. 


table-auto-width- 

method 


yes 


#f, string 


#f 


Specifies the method that 
determines the widths of 
colunms. 


table-border 


yes 


#t, #f, table-border 


#f 


Specifies the default value 
of row and column border 
characteristics. 


before-row-border 


no 


#t, #f, table-border 


table-border: 


Specifies the border on the 
side before the table in the 
row-progression direction. 


after-row-border 


no 


#t, #f, table-border 


table-border: 


Specifies the border on the 
side after the table in the 
row-progression direction. 
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Table 7-25 (cont.). Uncommon Characteristics of the Table Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


before-column- 

border 


no 


#t, #f, table-border 


table-border: 


Specifies the border on the 
side before the table in the 
column-progression 
direction 


after-column-border 


no 


#t, #f, table-border 


table-border: 


Specifies the border on the 
side after the table in the 
column-progression 
direction. 


table-border- 

rounded 


yes 


#f, #t, list 


#f 


Specifies whether the 
comers of the table are 
drawn as quarter circles. 


table-comer-radius 


yes 


length- spec 


3pt 


Specifies the radius of the 
quarter circles. 



Table 7-26. Common Characteristics of the Table Flow Object 



Characteristic 


Description 


position-preference 




display-alignment 




start-indent 




end-indent 




writing-mode 


Specifies the column-progression direction. 


span 




span-weak? 




space-before 




space-after 




keep- with-previous ? 




keep-with-next? 




break-before 




break-after 




keep 




may-violate-keep-before? 




may-violate-keep-after? 





7.3.7.2. The Table-part Flow Object 

Objects of this flow object class are only allowed within table flow objects. 
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Table 7-27. Ports of the Table-part Flow Object 



Port 


Objects 


Description 


#f 


table-column, table-row, 
table-cell 


Each row occurs exactly once, and the order of the rows 
is preserved. 


header 


table-row, table-cell 


Precedes the table each time it is broken unless 
t able -par t-omi t-middle-header? : #t. 


footer 


table-row, table-cell 


Follows the table each time it is broken unless 
table-part-omit-middle- footer? : #t. 



As result of formatting this flow object, portions of the main port will be generated, 
preceded by the header port and followed by the footer port unless omissions are spec- 
ified. Each row in the main port will occur just once in the order specified. The rows in 
the header and footer will be replicated each time the table is broken. 



Table 7-28. Uncommon Characteristics of the Table-part Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


table-part-omit- 

middle-header? 


yes 


boolean 


#f 


Specifies whether the header is replicated 
each break. 


table-part-omit- 

middle-footer? 


yes 


boolean 


#f 


Specifies whether the footer is replicated each 
break. 



Table 7-29. Common Characteristics of table-part 



Characteristic 

space-before 

space-after 

keep-with-previous? 

keep-with-next? 

break-before 

break-after 

keep 

may-violate-keep-before? 

may-violate-keep-after? 



7.3.7.3. The Table-column Flow Object 

The table-column flow object class is an atomic flow object class, and so has no ports. It 
is used to specify characteristics applicable to table-cells. Any inherited characteristics 
that are specified on a table-column are inherited by the table-cells if table cells have 
the same column and span. Each table-cell must have a corresponding table-column 
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unless table-auto- width is enabled. 

Table 7-30. Uncommon Characteristics of the Table-column Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


column-number 


no 


integer>0 


1 + column-number: of 
previous table-column, or 
1 


Specifies the starting 
column of cells that will 
inherit from this column. 


n-columns- spanned 


no 


integer>0 


1 


Specifies the number of 
columns that cells must 
span to inherit from this 
column. 


width 


no 


length- 

spec 


Can’t be specified when 
n-columns-spanned: > 1. 
Must be specified unless 
table-auto-width feature 
is present 


Specifies the width of this 
column. 



Table 7-31. Common Characteristics of the Table-column Flow Object 



Characteristic 


Description 


display-alignment 


Used for aligning the first line of each externally aligned paragraph in the 
column. 


start-indent 


Used for aligning the first line of each externally aligned paragraph in the 
colunrn. 


end-indent 


Used for aligning the first line of each externally aligned paragraph in the 
column. 



The table-auto-width feature affects how columns in tables are determined. When the 
feature is enabled, the number of columns is determined automatically from the content 
of the table. Otherwise, table-column objects are required to define columns and spans, 
meaning that for every cell in the content, and for every column spanned by that cell, 
there must be a table-column whose column-number is equal to the number of that 
column. The table-auto-width feature tries to calculate automatically the widths of the 
columns taking into account the content, and trying to accommodate it. 

table-unit 



(table-unit k) 



Returns a length- spec that divides the display size in k units. It may be used in the 
value of width :. This allows the width of a column to be specified proportion- 
ally. 
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Example 7-50. Proportionate table-columns 

Create a table with three columns, two of the same size, one with double size. It 

means four units of size. 

(make table 

(make table-column 
width; (table-unit 4)) 

(make table-column 
width: (table-unit 4)) 

(make table-column 
width: (* 2 (table-unit 4)))) 

Result. 

unit 1 unit 2 unit 3 unit 4 



7.3.7.4. The Table-row Flow Object 

A table -row flow object groups cells into rows. It can only occur as child of table 
or table-part. 

Table 7-32. Ports of the Table-row Flow Object 



Port 


Objects 


Description 


#f 


table-cell 


Cells starting in the same geometric row 



7.3.7.5. The Table-cell Flow Object 

Table-cells can only occur as children of table, table-part or table-row. 
When table-cells do not occur in a table-row, rows are constructed using the 
starts -row? : and ends -row? : characteristics. 

The alignment of the content of cells in the column-progression direction is controlled 
with the display-alignment : and quadding: characteristics of the content 
itself. 
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Table 7-33. Ports of the Table-cell Flow Object 



Port 


Objects 


#f 


D 



Table 7-34. Uncommon Characteristics of the Table-cell Flow Object 



Characteristic 


inh 


Vaiues 


Default 


Description 


column-number 


no 


integer>0 


1 or 1 + 
(value + 
span) of 
previous cell 


Specifies the starting column of this 
table-cell. It is used to avoid conflics 
with previous cells spanning several 
rows. 


n-columns- 

spanned 


no 


integer>0 


1 


Specifies the number of columns this 
cell spans. 


n-rows-spanned 


no 


integer>0 


1 


Specifies the number of rows which 
this cell spans. 


cell-before-row- 

margin 


yes 


length 


Opt 


Specifies the margin before the row. 


cell-after-row- 

margin 


yes 


length 


Opt 


Specifies the margin after the row. 


cell-before- 

column-margin 


yes 


length 


opt 


Specifies the margin before the 
column. 


cell-after- 

column-margin 


yes 


length 


opt 


Specifies the margin after the column. 


cell-row- 

alignment 


yes 


start, end, 
center 


start 


Specifies the alignment of the content 
of the cell. 


cell-background? 


yes 


boolean 


#f 


Specifies whether the cell has a solid 
background. 


background-color 


yes 


#f, color 


#f 




background-layer 


yes 


integer 


-1 


Specifies the layer of the background. 


cell-before-row- 

border 


yes 


#f, table- 
border 


#f 


! Specifies the border before the cell in 
the row-progression direction. 
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Table 7-34 (cont.). Uncommon Characteristics of the Table-cell Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


cell-after-row- 

border 


yes 


#f, table- 
border 


#f 


Specifies the border after the cell in the 
row-progression direction. 


cell-before- 

column-border 


yes 


#f, table- 
border 


#f 


Specifies the border before the cell in 
the column-progression direction. 


cell-after- 

column-border 


yes 


#f, table- 
border 


#f 


Specifies the border after the cell in the 
column-progression direction. 


starts-row? 


no 


boolean 


#f 


Specifies whether this cell starts a row. 
This is not allowed inside table-rows. 


ends-row? 


no 


boolean 


#f 


Specifies whether this cell ends a row. 
This is not allowed inside table-rows. 


cell-crossed? 


yes 


#f, with, 
against, 
both 


#f 


Specifies whether or not the cell is 
crossed. 


float-out- 

sidelines? 


yes 


boolean 


#f 


Specifies whether sidelines will be 
attached to the table instead of the cell. 


float-out- 

marginalia? 


yes 


boolean 


#f 


Specifies whether marginalia will be 
attached to the table instead of the cell. 


float-out-line- 

numbers? 


yes 


boolean 


#f 


Specifies whether line-numbers will be 
attacheds to the table instead of the 
cell. 



Table 7-35. Common Characteristics of table-cell 



Characteristic 


Description 


line-cap 


This applies to the lines drawn when cell-crossed ? : is not # f . 


line-dash 


This applies to the lines drawn when cell-crossed ? : is not # f . 


line-thickness 


This applies to the lines drawn when cell-crossed ? : is not # f . 


line-repeat 


This applies to the lines drawn when cell-crossed ? : is not # f . 


line-sep 


This applies to the lines drawn when cell-crossed? : is not #f . 
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Figure 7-21. Table-cell Diagram 
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Figure 7-23. Cell Crossing 
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Figure 7-24. Table Float-outs 




7.3.7.6. The Table-border Flow Object 

Table -borders are atomic flow objects. They are used to specify the border of a 
table-cell or a table as a whole. 

Table 7-36. Uncommon Characteristics of the Table-border Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


border-priority 


yes 


integer 


0 


Specifies how conflicts between 
borders are resolved. The largest 
priority wins. It is an error if two 
table-borders that aren’t identical have 
the same priority. 


border-alignment 


yes 


center, start, 
end, outside, 
inside 


center 


Specifies the alignment of the border’s 
line relative to the position of the 
border. 


border-present? 


yes 


boolean 


#t 


Specifies whether the border is present. 


border-omit-at- 

break? 


yes 


boolean 


#f 


Specifies whether this border will be 
omitted if adjacent to a break in the 
table. This applies only to borders 
parallel to the row-progression 
direction. 


line-miter-limit 


yes 


number 


10 


Specifies the miter limit for line joins 
(ISO/IEC 10180). 


line-join 


yes 


miter, round, 
bevel 


miter 


Specifies the join style of the line. 
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Table 7-37. Common Characteristics of the Table-border Flow Object 

Characteristic 

color 

layer 

line-cap 

line-dash 

line-thickness 

line-repeat 

line-sep 

The width of borders does not affect the width of cells, nor the positioning of the content 
of cells, nor the width of the table, not the size of the area produced by the table. In 
particular, the width of the table, as specified by table-width : is equal to the sum 
of the widths of the cells. 

7.S.7.7. Table Configurations 

Figure 7-25. Table with Table-part 
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Figure 7-26. Table without Table-part 




7.3.7.S. Inheritance of Characteristics in Tabies 

When inherited-c is called inside a table -cell, the inheritance mechanism behaves 
differently. In this case, if there is a table -column with the same column num- 
ber and span as the cell that specifies c, the procedure returns the value of c in the 
table-column. 

Example 7-51. Inheritance of Characteristics in Tables 



table or table-part 



*table-column 
^ n-columns-spanned: 2 




allowed 
only when 


table-columr 


table-colun 

L 


ir 


table-auto-v 


vidtl' 












1 




II 


table-cell ^ 

n-columns-spanned: 2 


f 





7.3.8. The Sideline Flow Object 

Use of this flow object class requires the sideline feature. 

The sideline flow object class is used to place a line parallel to the side of the text. 
This is a standard mechanism used to mark changes in the text of a document. The 
line is aligned by means of attachment areas associated to alignment-points. The 
paragraph flow object class generates alignment points with the 1 ine -number : , 
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first-line-align: and alignment-point-offset: characteristics. 

Alignment -point flow objects may also be created explicitly. 

Table 7-38. Ports of the Sideline Flow Object 



Port 


Objects 


Description 


#f 


m 


Display areas add attachments, inline areas are annotated. 



Table 7-39. Uncommon Characteristics of the Sideline Flow Object 



Characteristic 


Inh 


Vaiues 


Defauit 


Description 


sideline- side 


yes 


start, end, spread-inside, 
spread-outside, 
page-inside, page-outside 


??? 


Specifies the side for the 
line. 


sideline-sep 


yes 


length-spec 


??? 


Specifies the separation for 
the sideline attachment. 



Table 7-40. Common Characteristics of the Sideline Flow Object 



Characteristic 

color 

layer 

line-cap 

line-dash 

line-thickness 

line-repeat 

line-sep 



Figure 7-27. Diagram of the Sideline Flow Object 
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7.3.9. The Display-group Flow Object 

The display-group flow object class concatenates displayed flow objects. A 
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display- group is always displayed. 

Table 7-41. Ports of the Display-group Flow Object 



Port 


Objects 


#f 


D 



Table 7-42. Uncommon Characteristics of the Display-group Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


coalesce-id 


no 


#f, string 


#f 


Specifies the coalesce-id of the object. Only 
the first object with the same coalesce id will 
be kept into a top-float, bottom-float or 
footnote zone. In the body zone a value of # f 
is required. 



Table 7-43. Common Characteristics of the Display -group Flow Object 



Characteristic 

position-preference 

space-before 

space-after 

keep-with-previous? 

keep-with-next? 

break-before 

break-after 

keep 

may-violate-keep-before? 

may-violate-keep-after? 



7.3.10. The Character Flow Object 

The character flow object is the abstraction of a character. The character flow 
object is inlined and atomic. 

Table 7-44. Uncommon Characteristics of the Character Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


char 


no 


character 


char-map: 


Specifies the 
character; controls 
hyphenation and 
glyph selection. 
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Table 7-44 (cont.). Uncoimnon Characteristics of the Character Flow Object 



Characteristic 


Inh 


Vaiues 


Default 


Description 


char-map 


yes 


#f, procedure 


#f 


Specifies the 
procedure for the 
construction of the 
char: default 
value. 


glyph-id 


no 


#f, glyph-id 


glyph-id of char: 


Specifies the glyph 
for the character. 


glyph-subst-table 


yes 


#f, 

glyph-subst-table, 

’ (glyph-subst-table 
...) 


#f 


Specifies the 
substitutions to 
perform on 
glyph- id : . 


glyph-subst-method 


yes 


#f, string, ’(string 
...) 


#f 


Each string is the 
public-id of a glyph 
substitution method. 
Allows contextual 
and multiple 
substitutions. 


glyph-reorder- 

method 


yes 


#f, string, ’(string 
...) 


#f 


Used for indie 
scripts 


math-font-posture 


no 


#f, not-applicable, 
upright, oblique, 
back-slanted- 
oblique, italic, 
back- slanted-italic 


math-font-posture of 
char: 


Specifies the posture 
when 

font-posture : 
'math. 


stretch-factor 


no 


number 


1 


Specifies a factor by 
which the character 
is stretched. It is 
designed for 
delimiters 


hyphenate? 


yes 


boolean 


#f 


Specifies whether 
hyphenation is 
allowed. 


hyphenation-method 


yes 


#f, string 


#f 


Specifies the method 
of hyphenation. 
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Table 7-44 (cont.). Uncommon Characteristics of the Character Flow Object 



Characteristic 


inh 


Values 


Default 


Description 


kem? 


yes 


boolean 


#f 


Specifies whether 
adjustment of space 
between characters 
is performed 
according to 
kern-mode:, as 
specified in 8. 8. 1.6 
of ISO 4541-1. 
Escapement 
adjustment is not 
performed for 
glyphs with 
non- adjusting 
escapement. 


kem-mode 


yes 


loose, normal, kem, 
tight, touch 


normal 


Specifies the 
kerning mode. 


ligature? 


yes 


boolean 


#f 


Specifies whether 
ligatures are 
allowed. 


allowed-ligatures 


yes 


’(glyph-id 1 char ...) 


empty list 


Specifies the 
allowed glyphs for 
ligatures. 


space? 


no 


boolean 


space? of char: 


Specifies whether 
the character is a 
space. This affects 
whether inline- 
inline-space: 
applies to this 
object. 


inline-space-space 


yes 


inline-space 


?? 


Specifies space to 
add to 

escapement - 
space-before : 
and escapement- 
space-after : . 


escapement- space- 
before 


yes 


inline-space 


(inline-space Opt) 


Specifies the space 
to be added before 
the object. 










Specifies the space 
to be added after the 
object. 
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Table 7-44 (cont.). Uncoimnon Characteristics of the Character Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


record-end? 


no 


boolean 


record-end? of char: 


Specifies whether 
the character is a 
record-end. When 
# t it is treated 
differently by 
paragraphs with 
lines: 'as is or 
with ignore- 
record-end? : 
#t. 


input-tab? 


no 


boolean 


input- tab? of char: if 
not explicitly 
specified, #f 
otherwise 


Specifies whether 
the character is a tab 
on input. When # t 
it is treated 
differently by 
paragraphs with 
expand- tabs : 
not #f. 


input-whitespace- 

treatment 


yes 


preserve, collapse, 
ignore 


preserve 




input-whitespace? 


no 


boolean 


input-whitespace? 
of char: if not 
explicitly specified, 
#f otherwise 


Specifies whether 
the character is 
considered as 
whitespace on input. 


punct? 


no 


boolean 


punct? of char: 


Specifies whether it 
is treated as 
punctuation when 
formatting the 
paragraph with 
hanging 

punctuation. This 
takes effect only 
when the 

hanging-punct : 
#t. 


drop-after-line- 

break? 


no 


boolean 


drop- after-line- 
break? of char: 


Specifies whether 
this character is 
discarded when it 
follows a line break. 







252 



Chapter 7. The Style Process 



Table 7-44 (cont.). Uncommon Characteristics of the Character Flow Object 



Characteristic 


inh 


Values 


Defauit 


Description 


drop-unless-before- 

line-break? 


no 


boolean 


drop-unless-before- 
line-break? of char: 


Specifies whether 
this character is 
discarded unless it 
precedes a line 
break. 


math-class 


no 


ordinary, operator, 
binary, relation, 
opening, closing, 
punctuation, inner, 
space 


math-class of char: 


It is used for spacing 
characters in 
mathematical 
formulae. 


script 


no 


#f, string 


script of char: 


Specifies the formal 
public identifier of 
the character’s 
script. 



Several characteristics default to the value of predefined characteristics in the charac- 
ters. See Section 3.5.7. 1. A style-specification may define more characteris- 
tics for characters using add-char-properties. 



Table 7-45. Common Characteristics of the Character Flow Object 



Characteristic 


Default 


Description 


writing-mode 




Controls the writing-mode of the 
font used for the glyph metrics. 


font-family-name 






font-weight 






font-posture 






font-stmcture 






font-proportionate-width 






font-name 






font- size 






break-before-priority 


break-before-priority of char: 




break-after-priority 


break- after-priority of char: 




position-point- shift 






language 






country 






color 






layer 






inhibit-line-breaks? 
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7.3.10.1. Inline Spaces 

Inline-spaces are used for the value of the inline-space-space : , 
escapement-space-before: and escapement-space-after: 

characteristics of character flow objects. Spaces have been introduced in Section 
7.2.17 as the specification of the desired separation between areas. Concretely, 
inline- spaces are used to separate inline areas. Two procedures operate on 
inline- spaces. 

inline-space? 



(inline-space? ob j ) 

Returns # t when obj is an inline-space. 

inline-space 

(inline-space length-spec # ! key min: max:) 

Returns an object of type inline-space. 

• 1 ength-spec : is the nominal size of the space. 

• min : , max: are the minimum and maximum sizes for the space. Both default 
to length-spec :. 

Example 7-52. inline-space 

(inline-space 12pt min: lOpt max: 14pt) 



7.3.10.2. Glyph Id 

Glyph-id objects represent identifiers of glyphs. Glyphs are the graphics represent- 
ing characters. The difference between characters and glyphs is that characters convey 
distinction in meaning or sound, while glyphs convey distinction in form without pro- 
viding any meaning. Their relation is of the kind many to many. Glyph-id objects are 
used in the value of the glyph-id: characteristic of character flow objects. A 
glyph-identifier may also be an afii-glyph-identifier, following the syntax #An, where 
n is the numeric code of the glyph in ISO 10036 without leading zeros. An afii-glyph- 
identifier is a glyph accepted by the AFII organization, an equivalent to Unicode but 
not for characters but for glyphs. Two procedures operate on glyph-ids. 

glyph-id? 



(glyph- id? obj) 

Returns #t when obj is a glyph-id. 
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glyph-id 



(glyph-id public-id) 



Returns a glyph-id whose public identifier is public-id, an ISO 10036 identi- 
fier. 

Example 7-53. glyph-id and afii-glyph-identifier 

(glyph-id "ISO/IEC 10036/RA/ /Glyphs :: 003451 " ) 

is equivalent to the afii-glyph-identifier 

#A3451 



7.3.10.3. Glyph Subst Table 

An object of class glyph-subst-table represents a one to one relation between glyph- 
ids and is used in the glyph-subst-table : characteristic of character flow 
objects. There are three procedures that operate on glyph-subst- tables. 

glyph-subst-table? 



(glyph-subst-table? ob j ) 



Returns #t when obj is a glyph-subst-table. 

glyph-subst-table 



(glyph-subst-table ' ( (glyph-id-origin glyph-id-destination) . . .) ) 

Returns a glyph-subst-table with the list of pairs defining the projection of 
glyph-id-origin into glyph-id-destination. 

glyph-subst 



(glyph-subst glyph-subst-table glyph-id-to-be-substituted) 



Returns the glyph- id associated with glyph- id- to-be- substituted in 
glyph-subst-table. A glyph-id missing in glyph-subst-table is sub- 
stituted by itself. For each glyph-id the first substitution in the table will take place, 
and the rest will be ignored. 

Example 7-54. glyph-subst and glyph-subst-table 

(glyph-subst (glyph-subst-table M(#Al #A2) (#Al #A3) (#A4 #A6))) #A1) 

=> #A2 
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7.3.11. The Glyph-annotation Flow Object 

Flow objects of class glyph- anno tat ion are mainly used for characters, words 
or phrases that have an associated description of their meaning or pronunciation. The 
annotation is placed on the before side in the line-progression direction of the anno- 
tated glyphs. A glyph-annotation that has more than one annotated glyph is not broken 
between lines. Users should explicitly divide long annotations between several glyph- 
annotation objects. 



Table 7-46. Ports of the Glyph-annotation Flow Object 



Port 


Objects 


Description 


#f 


character 


annotated glyph 


annotation 


character 


annotation glyph 



Table 7-47. Uncommon Characteristics of the Glyph-annotation Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


annotation-glyph- 

placement 


yes 


centered, shouldered 


centered 


Specifies the nominal 
placement rule of the 
annotating glyph. 


annotation-glyph-style 


yes 


#f, string 


#f 


Specifies a public 
identifier for additional 
formatting rules. 



Table 7-48. Common Characteristics of the Glyph-annotation Flow Object 



Characteristic 

inhibit-line-breaks ? 

break-before-priority 

break-after-priority 



7.3.12. The Leader Flow Object 

The leader flow object class is an inlined flow object class that generates a line of 
repeated symbols. It is usually inserted between two related objects at the same height 
to make explicit their relation and enhance readability by helping the location of one 
element from the other by following the line. Leaders are often used when formatting 
tables of contents or indices. 

Table 7-49. Ports of the Leader Flow Object 



Port 


Objects 


Description 


#f 


inlined 


Inlined flow objects to be repeated. 
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Table 7-50. Uncommon Characteristics of the Leader Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


truncate-leader? 


yes 


boolean 


#f 


Specifies whether the last repetition of the 
sequence may be truncated. 


align-leader? 


yes 


boolean 


#t 


Specifies whether the leaders is aligned with 
an imaginary grid. 


min-leader-repeat 


yes 


integer>0 


1 


Specifies the minimum number of repetitions 
of the pattern. 



Table 7-51. Common Characteristics of the Leader Flow Object 



Characteristic 


Description 


length 


Must specified for a leader in a paragraph unless the leader occurs on 
the last line. 


inhibit-line-breaks ? 




break-before-priority 




break-after-priority 





Figure 7-28. Diagram of the Leader Flow Object 
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7.3.13. The Box Flow Object 

Box flow objects represent boxes, rectangles, squares surrounding parts of content. 
When a character needs to have a background color, it should be placed inside a bor- 
derless box with the desired background color. Boxes may be inlined or displayed. 

Table 7-52. Ports of the Box Flow Object 



Port 


Objects 


Description 


#f 


D/I 


Objects must be of the same display type as the box. 



Table 7-53. Uncommon Characteristics of the Box Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


box-type 


no 


border, 

background, 

both 


border 


Specifies whether the box has a 
border or background. 


box-open-end? 


yes 


boolean 


#f 


Specifies whether a broken box has an 
open end. 


background-color 


yes 


#f, color 


#f 


Applies when box- type : is not 
border. 


background-layer 


yes 


integer 


-1 


Applies when box- type : is not 
border. 


box-comer-rounded 


yes 


#f,#t, 
’(comer ...) 


#f 


Specifies whether the comers of the 
box are drawn as quarter circles, and 
which ones. Comers are designated 
combining the symbols before and 
after as in before-before. 


box-comer-radius 


yes 


length- spec 


3pt 


Specifies the radius of the quarter 
circles; negative values cause concave 
comers. 


box-border- 

alignment 


yes 


center, 

outside, 

inside 


outside 


Specifies the alignment of the border’s 
line relative to the position of the 
border. 


box-size-before 


yes 


length 


8pt 


When inlined, specifies the distance 
from the placement path to the edge 
of the box that is before the placement 
path in the line-progression direction. 


box-size-after 


yes 


length 


4pt 


When inlined, specifies the distance 
from the placement path to the edge 
of the box that is after the placement 
path in the line-progression direction. 


line-miter-limit 


yes 


number 


10 


Specifies the miter limit for line joins 
(see ISO 10180). This applies to box’s 
borders. 
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Table 7-53 (cont.). Uncommon Characteristics of the Box Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


line-join 


yes 
i 


miter, round, 
bevel 


miter 


Specifies the join style of the line. 



Figure 7-29. Diagram of the Box Flow Object 




Table 7-54. Common Characteristics of the Box Flow Object 



Characteristic 


Description 


display? 




color 


This applies to the box’s border. 


layer 


This applies to the box’s border. 


line-cap 


This applies to the box’s border. 


line-dash 


This applies to the box’s border. 


line-thickness 


This applies to the box’s border. 


line-repeat 


This applies to the box’s border. 


line-sep 


This applies to the box’s border. 


writing-mode 


When inline, this determines the placement of flow objects in the 
box. 


position-preference 




inhibit-line-breaks ? 


This applies only if the flow object is inlined. 
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Table 7-54 (cont.). Common Characteristics of the Box Flow Object 



Characteristic 


Description 


break-before-priority 


This applies only if the flow object is inlined. 


break-after-priority 


This applies only if the flow object is inlined. 


start-indent 


This applies only if the flow object is inlined. 


end-indent 


This applies only if the flow object is inlined. 


span 


This applies only if the flow object is inlined. 


span-weak? 


This applies only if the flow object is inlined. 


space-before 


This applies only if the flow object is inlined. 


space-after 


This applies only if the flow object is inlined. 


keep- with-previous ? 


This applies only if the flow object is inlined. 


keep-with-next? 


This applies only if the flow object is inlined. 


break-before 


This applies only if the flow object is inlined. 


break-after 


This applies only if the flow object is inlined. 


keep 


This applies only if the flow object is inlined. 


may-violate-keep-before? 


This applies only if the flow object is inlined. 


may-violate-keep-after? 


This applies only if the flow object is inlined. 



7.3.14. The Score Flow Object 

The score flow object class is used to score its content. 

Note: The Kendot scoring is achieved using the emphasizing-mark flow object class. 

Table 7-55. Uncommon Characteristics of the Score Flow Object 



Characteristic 


Inh 


Vaiues 


Defauit 


Description 


type 


no 


before, through, after, 
length-spec, character 


must be 
specified 


Specifies the kind and 
placement of the score. 


score- spaces? 




boolean 


#t 


Specifies whether the 
score applies to spaces. 



Table 7-56. Common Characteristics of the Score Flow Object 



Characteristic 


Description 


color 




layer 




line-cap 


This applies only when type : is a length-spec. 


line-dash 


This applies only when type : is a length-spec. 


line-thickness 


This applies only when type : is a length-spec. 
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Table 7-56 (cont.). Common Characteristics of the Score Flow Object 



Characteristic 


Description 


line-repeat 


This applies only when type ; is a length-spec. 


line-sep 


This applies only when type ; is a length-spec. 


inhibit-line-breaks? 




font-family-name 




font-weight 




font-posture 




font- structure 




font-proportionate-width 




font-name 




font-size 





Figure 7-30. Diagram of the Score Flow Object 



through 



before 




7.3.15. The Included-container-area Flow Object 

Use of this flow object class requires the included-container-area feature. 

The included-container-area flow object class results in a sequence of one or 
more areas each of which is specified as an area container. Flow objects of this class 
can be either inlined or displayed. 

Table 7-57. Ports of the Included-container-area Flow Object 



Port 


Objects 


#f 


I 
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Table 7-58. Uncommon Characteristics of the Included-container-area Flow Ob- 
ject 



Characteristic 


inh 


Values 


Default 


Description 


filling-direction 


yes 


top-to- 

bottom, 

left-to-right, 

right-to-left 


top-to-bottom 


Specifies the filling direction of the 
area container, which may be 
perpendicular to the placement 
direction. 


width 


no 


length 


??? 




height 


no 


length 


??? 




contents -alignment 


yes 


start, end, 
center, justify 


start 


Specifies the alignment of the 
content in the filling-direction. 


overflow- action 


yes 


truncate, 
error, repeat 


repeat 


Specifies the action to be taken if 
the content does not fit. 


contents-rotation 


no 


0, 90, 180, 
270 


0 


Specifies the counter-clockwise 
rotation to apply to the content. 


scale 


no 


number 


1 


Specifies the scaling factor to 
apply to the content. Numbers less 
than 1 make the content smaller. 
Numbers greater than 1 make it 
larger. 



Table 7-59. Common Characteristics of the Included-container-area Flow Object 



Characteristic 


Default 


Description 


display? 






position-preference 






display-alignment 




Applies if flow object is displayed. 


start-indent 




Applies if flow object is displayed. 


end-indent 




Applies if flow object is displayed. 


writing-mode 




Applies if flow object is displayed. 


span 




Applies if flow object is displayed. 


span-weak? 




Applies if flow object is displayed. 


space-before 




Applies if flow object is displayed. 


space-after 




Applies if flow object is displayed. 


keep- with-previous ? 




Applies if flow object is displayed. 


keep-with-next? 




Applies if flow object is displayed. 


break-before 




Applies if flow object is displayed. 


break-after 




Applies if flow object is displayed. 
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Table 7-59 (cont.). Common Characteristics of the Included-container-area Flow Object 



Characteristic 


Defauit 


Description 


keep 




Applies if flow object is displayed. 


may-violate-keep-before? 




Applies if flow object is displayed. 


may-violate-keep-after? 




Applies if flow object is displayed. 


position-point-x 






position-point-y 






escapement-direction 


writing-mode: 


Applies if flow object is inlined. 


inhibit-line-breaks ? 




Applies if flow object is inlined. 


break-before-priority 




Applies if flow object is inlined. 


break-after-priority 




Applies if flow object is inlined. 



7.3.16. The External-graphic Flow Object 

The external -graphic is used for graphics contained in an external entity. Flow 
objects of this class are atomic, and may be inlined or displayed. 

Table 7-60. Uncommon Characteristics of the External-graphic Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


scale 


no 


number, 

’(number 

number), 

max, 

max-uniform 


max-uniform 


Specifies the scaling factor of the 
graphic. 


max-width 


no 


length- spec 


??? 


Specifies the maximum allowed 
width when scale: is either max 
or max-uniform. 


max-height 


no 


length-spec 


??? 


Specifies the maximum allowed 
height when scale: is either max 
or max-uniform. 


entity- system-id 


no 


#f, string 


must be 
specified 


Specifies the entity containing the 
external graphic. 


notation- system- 
id 


no 


string 


must be 
specified 


Specifies the notation of the external 
graphic. 



Table 7-61. Common Characteristics of the External-graphic Flow Object 



Characteristic 


Default 


Description 


display? 






color 
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Table 7-61 (cont.). Common Characteristics of the Extemal-gra 


phic Flow Object 


Characteristic 


Default 


Description 


layer 






position-preference 






display-alignment 




Applies only if the flow object is 
displayed. 


start-indent 




Applies only if the flow object is 
displayed. 


end-indent 




Applies only if the flow object is 
displayed. 


writing-mode 




Applies only if the flow object is 
displayed. 


span 




Applies only if the flow object is 
displayed. 


span-weak? 




Applies only if the flow object is 
displayed. 


space-before 




Applies only if the flow object is 
displayed. 


space-after 




Applies only if the flow object is 
displayed. 


keep- with-previous ? 




Applies only if the flow object is 
displayed. 


keep-with-next? 




Applies only if the flow object is 
displayed. 


break-before 




Applies only if the flow object is 
displayed. 


break-after 




Applies only if the flow object is 
displayed. 


keep 




Applies only if the flow object is 
displayed. 


may-violate-keep-before? 




Applies only if the flow object is 
displayed. 


may-violate-keep-after? 




Applies only if the flow object is 
displayed. 


position-point-x 


0 when the 
wri ting-mode : is 
left-to-right or 
right-to-left. 




position-point-y 


0 when the 
writing-mode : is 
top-to-bottom. 
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Table 7-61 (cont.). Common Characteristics of the Extemal-gra] 


phic Flow Object 


Characteristic 


Default 


Description 


escapement-direction 


writing-mode: 


Applies only if the flow object is 
inlined. 


inhibit-line-breaks ? 




Applies only if the flow object is 
inlined. 


break-before-priority 




Applies only if the flow object is 
inlined. 


break- after-priority 




Applies only if the flow object is 
inlined. 



7.3.17. The Rule Flow Object 

The rule flow object specifies a straight line. It is an atomic flow object class, and 
may be inlined or displayed. 

Table 7-62. Uncommon Characteristics of the Rule Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


orientation 


no 


horizontal, 

vertical, 

escapement, 

line-progression 


must be 
specified 


Specifies the orientation of the rule, 
and whether it is inlined or displayed, 
line-progression does not affect the 
positioning of subsequent flow 
objects. 



Figure 7-31. Diagram of the Rule Flow Object 
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Table 7-63. Common Characteristics of the Rule Flow Object 



Characteristic 


Description 


length 




color 




layer 




line-cap 




line-dash 




line-thickness 




line-repeat 




line-sep 




position-point-shift 




inhibit-line-breaks ? 




break-before-priority 


Applies only when the object is inlined. 


break-after-priority 


Applies only when the object is inlined. 


position-preference 




display-alignment 


Applies only when the object is displayed. 


start-indent 


Applies only when the object is displayed. 


end-indent 


Applies only when the object is displayed. 


writing-mode 


Applies only when the object is displayed. 


span 


Applies only when the object is displayed. 


span-weak? 


Applies only when the object is displayed. 


space-before 


Applies only when the object is displayed. 


space-after 


Applies only when the object is displayed. 


keep-with-previous? 


Applies only when the object is displayed. 


keep-with-next? 


Applies only when the object is displayed. 


break-before 


Applies only when the object is displayed. 


break-after 


Applies only when the object is displayed. 


keep 


Applies only when the object is displayed. 


may-violate-keep-before? 


Applies only when the object is displayed. 


may-violate-keep-after? 


Applies only when the object is displayed. 



7.3.18. The Embedded-text Flow Object 

Use of this flow object requires the bidi feature. 

It is used for embedding right-to-left text within left-to-right-text, or vice versa. It is 
always inlined. 
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The effect of embedded-text is to make any line fragments that contain the content of 
the embedded flow object use the specified direction as their inline-progression direc- 
tion. 

Table 7-64. Ports of the Embedded-text Flow Object 



Port 


Objects 


#f 


unspecified 



Table 7-65. Uncommon Characteristics of the Embedded-text Flow Object 



Characteristic 


Inh 


Vaiues 


Default 


Description 


direction 


no 


left-to-right, 

right-to-left 


must be 
specified 


Specifies the direction which must be 
parallel to the writing-mode of the 
paragraph 



Table 7-66. Common Characteristics of the Embedded-text Flow Object 



Characteristic 

language 

country 

inhibit-line-breaks? 



Figure 7-32. Diagram of the Embedded-text Flow Object 

T“ — , 

This is |tfel-ot-thgir1 inside left-to-right 



7.3.19. The Anchor Flow Object 

Use of this flow object requires the page feature. 

It is atomic and is used only for synchronization. It can be either inlined or displayed, 
and produces an area with zero size which will be kept with the first area unless 
anchor-keep-with-previous? : #t. 

Table 7-67. Uncommon Characteristics of the Anchor Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


anchor-keep- 

with-previous? 


yes 


boolean 


#f 


Specifies whether the object is kept together 
with the last one instead of the following one. 
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Table 7-68. Common Characteristics of the Anchor Flow Object 



Characteristic 

display? 

span 

span-weak? 
inhibit-line-breaks ? 
break-before-priority 
break-after-priority 



7.3.20. The Sequence Flow Object 

A sequence flow object concatenates the flow objects contained. A sequence will 
be accepted in a port if all objects contained would be accepted in the port. 

The sequence flow object is useful for specifying inherited characteristics that will 
be transmitted to the contained objects. Every inherited characteristic may be specified 
in a sequence object. Given the quantity of inherited characteristics, and that they are 
already explained in other sections, they will not be duplicated in this section. 

The effect of this flow object is similar to the value returned by the sosofo-append 
procedure, but with the difference that inherited characteristics may be specified. 

Table 7-69. Ports of the Sequence Flow Object 



Port 


Objects 


#f 


D/I 



7.3.21. The Aligned-column Flow Object 

Use of this flow object requires the aligned-column feature. 

An aligned- column flow object groups together externally aligned 
paragraphs. Paragraphs with alignment-point-offset: #f are 
externally aligned and must have a table-cell or aligned-column ancestor. 

Externally aligned paragraphs in the content or in side-by-side flow objects in 
the content are aligned so that their alignment points lie on a line in the placement 
direction. The resulting group of aligned lines is then positioned according to 
display-alignment start-indent : and end- indent ;. 

Table 7-70. Ports of the Aligned-column Flow Object 



Port 


Objects 


Description 


#f 


D 


Display objects that are not externally aligned 
paragraphs are formatted normally. 
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Table 7-71. Common Characteristics of the Aligned-column Flow Object 



Characteristic 


Description 


display-alignment 


Specifies the alignment in the writing mode. This is used for 
aligning the first line of each externally aligned paragraph. 


start-indent 


Specifies the indent for the edge at the start in the writing-mode. 
This is used for aligning the first line of each externally aligned 
paragraph. 


end-indent 


Specifies the indent for the edge at the end in the writing-mode. 
This is used for aligning the first line of each externally aligned 
paragraph. 


writing-mode 




position-preference 




space-before 




space-after 




keep- with-previous ? 




keep-with-next? 




break-before 




break-after 




keep 




may-violate-keep-before? 




may-violate-keep-after? 
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Example 7-55. Diagram of the Aligned-column Flow Object 
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7.3.22. The Multi-line-inline-note Flow Object 

Use of this flow object requires the inline-note feature. 

The multi-line -inline -note flow object used for inserting annotations inline 
that occupy more than one line. It uses a smaller font size, and its content is divided in 
a specified number of lines. 

Table 7-72. Ports of the Multi-line-inline-note Flow Object 



Port 


Objects 


Description 


#f 


I 


Content that will generate lines of approximately equal length. 



Table 7-73. Uncommon Characteristics of the Multi-line-inline-note Flow Object 



Characteristic 


Inh 


Vaiues 


Default 


Description 


open 


no 


unlabeled inline 
sosofo 


(literal 


Specifies the character opening 
the note. 


close 


no 


unlabeled inline 
sosofo 


(literal 

")") 


Specifies the character closing 
the note. 


inline-note-line-count 


yes 


integer>0 


2 


Specifies the number of lines in 
the note. 
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Table 7-73 (cont.). Uncommon Characteristics of the Multi-linc-inlinc-note Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


inline-note- style 


yes 


#f, string 


#f 


Specifies the public identifier of 
additional or detailed 
formatting rules. 



Figure 7-33. Diagram of the Multi-line-inline-note Flow Object 
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Table 7-74. Common Characteristics of the Multi-line-inline-note Flow Object 



Characteristic 

inhibit-line-breaks? 

break-before-priority 

break-after-priority 



7.3.23. The Emphasizing-mark Flow Object 

Use of this flow object class requires the emphasizing-mark feature. 

The emphasizing -mark flow object is used for emphasizing characters, words 
or phrases. Each emphasizing-mark is placed on a path that is perpendicular to 
the line progression direction and that lies before the placement path in the 
line-progression direction. This path is called the emphasizing-mark placement path. 
The emphasizing -mark flow object class can be used to handle the Kendot 
feature of Japanese typesetting in a generalized way. 

Table 7-75. Uncommon Characteristics of the Emphasizing-mark Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


mark 


no 


unlabeled 
inline sosofo 


shall not be 
defaulted 


Specifies the emphasizing mark. 


mark-distribution 


yes 


glyph, even 


glyph 


Specifies the distribution of the 
emphasizing marks, glyph is for 
monospaced fonts. 


mark- style 


yes 


#f, string 


#f 


Specifies the public identifier of 
additional or detailed rules to be 
applied in formatting the object. 
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Table 7-76. Common Characteristics of the Emphasizing-mark Flow Object 



Characteristic 

inhibit-line-breaks? 

break-before-priority 

break-after-priority 



7.3.24. Classes for Mathematical Formulae 

Use of flow objects in this section require the math feature. 

These flow object classes may also be used for ‘linear’ chemical formulae. 

7.3.24.1. The Math-sequence Flow Object 

A math- sequence flow object produces a single area. 

Table 7-77. Ports of the Math-sequence Flow Object 



Port 


Objects 


Description 


#f 


math-sequence, unmath, subscript, 
superscript, script, mark, fence, fraction, 
radical, math-operator, grid, character, 
alignment-point 


The spacing is adjusted based on class 
and characteristics. 



Table 7-78. Uncommon Characteristics of the Math-sequence Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


math-display-mode 


yes 


display, inline 


display 


Specifies the style of formatting. 



7.3.24.2. The Unmath Flow Object 

It allows the insertion of words of natural language within a mathematical formula. 

Table 7-79. Ports of the Unmath Flow Object 



Port 


Objects 


Description 


#f 


inline flow objects 


Characters of the words. 



Table 7-80. Uncommon Characteristics of the Unmath Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


glyph- alignment-mode 


yes 

i 


base, center, top, 
bottom, font 


font 


Specifies the alignment 
mode for glyphs. 
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Table 7-81. Common Characteristics of the Unmath Flow Object 



Characteristic 


Description 


writing-mode 




font-family-name 


This applies when glyph- alignment -mode : 


'font. 


font-weight 


This applies when glyph- alignment -mode : 


'font. 


font-posture 


This applies when glyph- alignment -mode : 


'font. 


font-structure 


This applies when glyph- alignment -mode : 


'font. 


font-proportionate-width 


This applies when glyph-alignment-mode : 


' fon t. 


font-name 


This applies when glyph- alignment -mode : 


' fon t. 



7.3.24.3. The Script Flow Object 

Table 7-82. Ports of the Script Flow Object 



Port 


Objects 


Description 


#f 


math-sequence, unmath, subscript, 
superscript, script, mark, fence, fraction, 
radical, math-operator, grid, character, 
alignment-point 


The main content. 


pre-sup 


math-sequence, unmath, subscript, 
superscript, script, mark, fence, fraction, 
radical, math-operator, grid, character, 
alignment-point 


The superscript placed before the base 
content. 


pre-sub 


math-sequence, unmath, subscript, 
superscript, script, mark, fence, fraction, 
radical, math-operator, grid, character, 
alignment-point 


The subscript placed before the base 
content. 


post-sup 


math- sequence, unmath, subscript, 
superscript, script, mark, fence, fraction, 
radical, math-operator, grid, character, 
alignment-point 


The superscript placed after the base 
content. 


post-sub 


math- sequence, unmath, subscript, 
superscript, script, mark, fence, fraction, 
radical, math-operator, grid, character, 
alignment-point 


The subscript placed after the base 
content. 


mid- sup 


math-sequence, unmath, subscript, 
superscript, script, mark, fence, fraction, 
radical, math-operator, grid, character, 
alignment-point 


The superscript placed above the base 
content. 
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Table 7-82 (cont.). Ports of the Script Flow Object 



Port 


Objects 


Description 


mid- sub 


math-sequence, unmath, subscript, 
superscript, script, mark, fence, fraction, 
radical, math-operator, grid, character, 
alignment-point 


The subscript placed below the base 
content. 



Table 7-83. Uncommon Characteristics of the Script Flow Object 



Characteristic 


Inh 


Vaiues 


Default 


Description 


script-pre- align 


yes 


independent, pile, 
sup-out, sub-out 


independent 


Specifies the alignment 
of the pre- superscript 
and pre-subscript areas. 


script-post- align 


yes 


independent, pile, 
sup-out, sub-out 


independent 


Specifies the alignment 
of the post-superscript 
and post-subscript 
areas. 


script-mid-sup-align 


yes 


lead-edge, trail-edge, 
center 


center 


Specifies the alignment 
of the mid- superscript 
and base areas. 


script-mid-sub-align 


yes 


lead-edge, trail-edge, 
center 


center 


Specifies the alignment 
of the mid-subscript 
and base areas. 


math-display-mode 


yes 


display, inline 


display 


Specifies the style of 
formatting. 



Figure 7-34. Diagram of the Script Object 
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7.3.24.4. The Mark Flow Object 

Table 7-84. Ports of the Mark Flow Object 



Port 


Objects 


Description 


#f 


math-sequence, unmath, subscript, 
superscript, script, mark, fence, 
fraction, radical, math-operator, grid, 
character, alignment-point 


The main content. 


over-mark 


math-sequence, unmath, subscript, 
superscript, script, mark, fence, 
fraction, radical, math-operator, grid, 
character, alignment-point 


Flow objects placed over the mark. If it 
contains exactly one character, rule or 
leader flow object, then that flow 
object extends to cover the full width 
of the base area. 


under-mark 


math-sequence, unmath, subscript, 
superscript, script, mark, fence, 
fraction, radical, math-operator, grid, 
character, alignment-point 


Flow objects placed under the mark. If 
it contains exactly one character, rule 
or leader flow object, then that flow 
object extends to cover the full width 
of the base area. 



Note: The standard is unclear for this flow object. On one side it points out that ports accept the 
same flow objects as the ports of math- sequence, but later it can be deduced that rule and 
leader may also occur. 



Table 7-85. Uncommon Characteristics of the Mark Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


math-display-mode 


yes 


display, inline 


display 


Specifies the style of 
formatting. 



Figure 7-35. Diagram of the Mark Flow Object 
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7.3.24.5. The Fence Flow Object 

Table 7-86. Ports of the Fence Flow Object 



Port 


— 

Objects 


Description 


#f 


math-sequence, unmath, subscript, 
superscript, script, mark, fence, fraction, 
radical, math-operator, grid, character, 
alignment-point 


The main content. 


Open 


character 


Character opening the fence. It extends 
according to the height of the base area. 


close 


character 


Character closing the fence. It extends 
according to the height of the base area. 



Table 7-87. Uncommon Characteristics of the Fence Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


math-display-mode 


yes 


display, inline 


display 


Specifies the style of 
formatting. 



Figure 7-36. Diagram of the Fence Flow Object 



dose 




7.3.24.6. The Fraction Flow Object 

Table 7-88. Ports of the Fraction Flow Object 



Port 


Objects 


numerator 


math-sequence, unmath, subscript, superscript, script, mark, fence, fraction, 
radical, math-operator, grid, character, alignment-point 


denominator 


math-sequence, unmath, subscript, superscript, script, mark, fence, fraction, 
radical, math-operator, grid, character, alignment-point 
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Table 7-89. Uncommon Characteristics of the Fraction Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


fraction-bar 


yes 


rule flow object 


rule with all 

characteristics 

defaulted 


Specifles the line of the 
fraction. 


numerator-align 


yes 


lead-edge, 
trail-edge, center 


center 


Specifies the alignment of the 
numerator and the fraction 
bar. 


denominator- align 


yes 


lead-edge, 
trail-edge, center 


center 


Specifies the alignment of the 
denominator and the fraction 
bar. 


math-display-mode 


yes 


display, inline 


display 


Specifies the style of 
formatting. 



Figure 7-37. Diagram of the Fraction Flow Object 




denominator 



x+y 

x-y 



7.3.24.7. The Radical Flow Object 

Table 7-90. Ports of the Radical Flow Object 



Port 


Objects 


Description 


#f 


math-sequence, unmath, subscript, 
superscript, script, mark, fence, fraction, 
radical, math-operator, grid, character, 
alignment-point 


The main content. 
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Table 7-90 (cont.). Ports of the Radical Flow Object 



Port 


Objects 


Description 


degree 


math- sequence, unmath, subscript, 
superscript, script, mark, fence, fraction, 
radical, math-operator, grid, character, 
alignment-point 


The degree of the root. 



Table 7-91. Uncommon Characteristics of the Radical Flow Object 



Characteristic 


Inh 


— 

Values 


Default 


Description 


math-display- 

mode 


yes 


display, inline 


display 


Specifies the 
style of 
formatting. 


radical 


no 


character 


system- 

dependent 


Specifies the 
radical glyph. 



Figure 7-38. Diagram of the Radical Flow Object 




7.3.24.8. The Math-operator Flow Object 

Table 7-92. Ports of the Math-operator Flow Object 



Port 


Objects 


Description 


#f 


math-sequence, unmath, subscript, superscript, 
script, mark, fence, fraction, radical, math-operator, 
grid, character, alignment-point 


Main content. 


operator 


math-sequence, unmath, subscript, superscript, 
script, mark, fence, fraction, radical, math-operator, 
grid, character, alignment-point 


The operator symbol. 


lower-limit 


math-sequence, unmath, subscript, superscript, 
script, mark, fence, fraction, radical, math-operator, 
grid, character, alignment-point 


The lower-limit content 
of the flow object. 


upper-limit 


math-sequence, unmath, subscript, superscript, 
script, mark, fence, fraction, radical, math-operator, 
grid, character, alignment-point 


The upper-limit content 
of the flow object. 



Note: It is unclear which is the content accepted by the ports. Concretely the author supposes 
operator should be a character, but any math flow object is allowed as specified. 
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Table 7-93. Uncommon Characteristics of the Math-operator Flow Object 



Characteristic 


Inh 


Vaiues 


Defauit 


Description 


math-display-mode 


yes 


display, 

inline 


display 


Specifies the style of formatting. It decides 
whether the limits are placed before or after 
the operator. 



Figure 7-39. Diagram of the Math-operator Object 




100 




7.3.24.9. The Grid Flow Object 

The grid flow object describes a series of areas arranged in a grid. A matrix is handled 
by enclosing a grid in a fence. The column-progression direction for the grid is the es- 
capement direction, and the row-progression direction is the line-progression direction. 

Table 7-94. Ports of the Grid Flow Object 



Port 


Objects 


Description 


#f 


grid-cell 


used for all content 



Table 7-95. Uncommon Characteristics of the Grid Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


grid-position- 

cell-type 


yes 


explicit, 

row-major, 

column- 

major 


row- 

major 


Specifies the positioning of cells in the 
grid. 


grid-n-columns 


no 


integer>0 


must be 
specified 


Specifies the number of columns in the 
grid. 
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Table 7-95 (cont.). Uncommon Characteristics of the Grid Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


grid-n-rows 


no 


integer>0 


must be 
specified 


Specifies the number of rows in the grid. 


grid-column- 

alignment 


yes 


start, center, 
end 


center 


Specifies how columns are aligned. 


grid-row- 

alignment 


yes 


start, center, 
end 


center 


Specifies how rows are aligned. 


grid-equidistant- 

rows? 


yes 


boolean 


#f 


Specifies whether rows are distributed 
evenly. 


grid-equidistant- 

columns? 


yes 


boolean 


#f 


Specifies whether colunms are 
distributed evenly. 


math-display- 

mode 


yes 


display, inline 


display 


Specifies the style of formatting. 



Figure 7-40. Diagram of the Grid Flow Object 



ghd-n-columns: 

< > 




7.3.24.10. The Grid-cell Flow Object 

The grid-cell flow object is a container for the content of each cell in a grid. 

Table 7-96. Ports of the Grid-cell Flow Object 



Port 


Objects 


Description 


#f 


math-sequence, unmath, subscript, superscript, script, mark, fence, 
fraction, radical, math-operator, grid, character, alignment-point 


Used for all 
content. 
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Table 7-97. Uncommon Characteristics of the Grid-cell Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


column-number 


no 


0 < integer <grid- 
n-columns: 


must be 
specified 


First column is 1. This 
characteristic must be specified in 
grids with 

grid-posi t ion-cell- type : 
' expl i ci t. 


row-number 


no 


0 < integer <grid- 
n-rows: 


must be 
specified 


First row is 1 . This characteristic 
must be specified in grids with 
gri d -posi tion- cel 1 - type : 
'expl id t. 



In any grid, there shall not be two or more grid cells that have both the same 
col umn-number : and row-number : . 



7.3.25. Online flow objects 

Use of flow object classes in this section require the online feature. 

7.3.25.1 . The Scroll Flow Object 

The scroll flow object is used as the root flow object for online display when con- 
tinuous output is desired. 

The size of the flow object in the direction perpendicular to the filling-direction depends 
on the viewing environment. 

Table 7-98. Ports of the Scroll Flow Object 



Port 


Objects 


#f 


D 



Table 7-99. Uncommon Characteristics of the Scroll Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


filling-direction 


yes 


top-to- 

bottom, 

left-to-right, 

right-to-left 


top-to-bottom 


It may be perpendicular to the 
placement direction. 


background-color 


yes 


#f, color 


#f 


Specifies the color of the 
background. 


background-layer 


yes 


integer 


-1 


Specifies the layer of the 
background. 
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Table 7-99 (cont.). Uncommon Characteristics of the Scroll Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


background-tile 


yes 


#f, public id 
of an image 


#f 


Specifies the image that should be 
repeated to cover the background of 
the scroll. 


start-margin 


yes 


length-spec 


Opt 


Specifies the distance from the edge 
that is first in the writing-mode 
direction to the nearest text area. 


end-margin 


yes 


length-spec 


opt 


Specifies the distance from the edge 
that is last in the writing-mode 
direction to the nearest text area. 



Table 7-100. Common Characteristics of the Scroll Flow Object 



Characteristic 


Description 


writing-mode 


This is used to determine which side of the flow object the 
start-margin: and end-margin : characteristics apply to. 



7.3.25.2. The Multi-mode Flow Object 

A multi -mode flow object has two or more modes of presentation. The flow object 
can be switched between these modes of presentation in a system-dependent way. An 
implementation might present a menu of the different modes. Alternatively, clicking 
on the formatted flow object might cycle through the modes. The object is inlined or 
displayed according to its content and mode of presentation. 

Table 7-101. Ports of the Multi-mode Flow Object 



Port 

One for each mode. 



Table 7-102. Uncommon Characteristics of the Multi-mode Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


multi-modes 


no 


’(mode ...) 


must be 
specified 


number of modes of presentation 


principal-mode- 

simultaneous? 


yes 


boolean 


#f 


Specifies whether the principal mode is 
simultaneous with the other modes. If so, 
when the current mode is not #f, both the 
content of #f and the current mode are 
displayed. 



7.3.25.3. The Link Flow Object 

The link flow object class represents a hypertext link that can be interactively tra- 
versed, typically by clicking on the areas representing the flow object and its content. 
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Table 7-103. Ports of the Link Flow Object 



Port 


Objects 


Description 


#f 


any 


link flow objects can be nested, and the innermost link is effective 



Table 7-104. Uncommon Characteristics of the Link Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


destination 


no 


#f, address, 
’(address ...) 


must be specified 


#f is used for a nested link 
and indicates that the 
contents of the flow object 
shall not be considered part 
of the containing link. 



7.3.25.3.1. Addresses 

An object of type address is used as destination of an hypertext link in the destination: 
characteristic of link flow object class. The standard offers a set of procedures to 
specify objects of type address. 

address? 



(address? ob j ) 



Returns #t when obj is an address. 

address-local? 



(address-local? address) 



Returns #t when address is local to the current document. 

address-visited? 

(address-visited? address) 

Returns #t when address has been visited. It can be used to change the render- 
ing of the link. 

idref-address 



( idref-address string) 



Returns an address representing the elements whose IDs are contained in 
string. 

current-node-address 



(current-node-address) 
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Returns an address for the current node. 

entity-address 

(entity-address string) 

Returns an address representing the entities whose names are contained in 
string. 

sgmi-document-address 

(sgml -document -address system-id id) 

Returns an address for the element with id in the SGML document system-id. 

node-list-address 

(node-list-address nl) 

Returns an address for nl. This procedure requires the query feature. 

External procedures can also be used for other addressing mechanisms. 

7.3.25.4. The Marginalia Flow Object 

The marginalia flow object class is used to contain attachment areas for the line 
in which the marginalia flow object occurs. It shall have an ancestor of class 
paragraph. 

Table 7-105. Ports of the Marginalia Flow Object 



Port 


Objects 


#f 


Inline. 



Table 7-106. Uncommon Characteristics of the Marginalia Flow Object 



Characteristic 


Inh 


Values 


Default 


Description 


marginalia-sep 


yes 


length-spec 


Opt 


Specifies the separation for the 
attachment. 


marginalia-side 


yes 


start, end 


start 


Specifies the side of the line the 
marginalia is attached to. 


marginalia-keep- 

with-previous? 


yes 


boolean 


#f 


Specifies whether the marginalia is 
associated with the previous area instead 
of the following one. 



7.4. Additional Classes 

An application may declare flow objects and characteristics that are not supported by 
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the standard. 

declare-f low-object-class 

(declare-f low-object-class identifier public-id) 

Declares identifier to be a flow object class name for a class with 
public-id. 

declare-characteristic 



(declare-characteristic identifier public-id initial-value) 



Declares identifier to be an additional inherited characteristic. It 
has also the effect of declaring procedures inherited- identifier and 
actual- identifier, public-id specifies the semantics of the characteristic. 

declare-char-characterlstic+property 



(declare -char -character is tic+property 
identifier 
public-id 
default -value) 



Declares identifier to be an additional non-inherited characteristic of a 
character flow object and also declares identifier to be an additional 
character property, public-id specifies the semantics of the characteristic. 
The default value of the characteristic is the value of the identifier property 
of the character that is the value of the char: characteristic of the flow object. 

declare-initial-value 



(declare-initial-value identifier expression) 



Declares the initial value of the inherited characteristic identifier to be an 
expression. This shall not be used for characteristics declared with declare- 
characteristic. 



7.5. Basic example 

This section is intended to provide the reader with some ideas of the type of style 
process that can be specified with DSSSL. 

The example below was offered by Jany Quintard. It is a program to generate a phone- 
book where each letter is placed on a new page. 

The DTD for the documents that this stylesheet processes is the one below. 



<?xml encoding= " iso-8859-1 " ?> 

<!-- This DTD can be freely used, copied, modified 
or redistributed 
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Jany Quintard May 2003 

The DTD has two root elements : 

- annuvrac: is used for storage of the information. 

It can contain correspondants (persons or organisms) , 
addresses and coordinates in any order. As several 
persons can share an address and coordinates, 
they are not included but linked, 
using ID and IDREF . 

- annuedit: is used for processing with dsssl to 
obtain an XML file suitable for printing. 

The basic element is entry. Each correspondant 
can be used to generate several entries, which 
are alphabetically sorted. 

To transform annuvrac to annuedit a custom 
process is used. 

The structural trees are generated using dtdtree from 
the package perlsgml by Earl Hood. 

annuvrac 
_ (person | 

I _EMPTY 

organism | 

I _ (address* , . . . 

I coords?) . . . 

address | 

|_ ( imm? , 

I |_(#PCDATA) 

I 

I street?, 

I I _EMPTY 

I 

I city? , 

I |_(#PCDATA) 

I 

|_cp?, 

I |_(#PCDATA) 



I state? , 

I |_(#PCDATA) 

I 

I tel* , 

I I _EMPTY 

I 

I COMMENT?) 

coords) * 

|_(url I 
I I _EMPTY 

I 

1 email | 

I I _EMPTY 

I 

I tel) * ... 
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annuedit 
I _ (entries , 

I I _ (entry*) 

I |_( (person | 

I I I _EMPTY 



I organism) ) 

|_(address* , . . . 

I coords?) . . . 



addresses, 

I _ (address*) 

|_ ( imm? , 

I |_(#PCDATA) 



I street?, 

I I _EMPTY 

I city? , 

I |_(#PCDATA) 

I cp ? , 

I |_(#PCDATA) 

I state?, 

I |_(#PCDATA) 



I I _EMPTY 

I 

I COMMENT?) 



coordinates ) 

|_(coords*) 
|_(url I 



1 _EMPTY 



I email [ 

I I _EMPTY 



I tel) * . . . 



--> 

<!-- Root elements --> 

<! ELEMENT annuvrac (person | organism | address | coords) *> 

<! ELEMENT annuedit (entries , addresses , coordinates) > 

<!-- Common "classical" attributes --> 

<! ENTITY % Common. Atts 

"ID ID #REQUIRED"> 

<!-- The phone book contains info on correspondants . --> 

<! ENTITY % Correspondant " (person | organism) " > 

<! ENTITY % Corresp.AttS 

"address IDREF # IMPLIED "> 



<!-- An address contains : 
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iiran name or number of building 

street description of the street 

city 

CP Postal code 

tel telephon 

comment) 

--> 

< ! ELEMENT address 

( imm? , street? , city? , CP? , state? , tel* , comment? ) > 
<!-- IS03166 is the code of the country --> 

<!ATTLIST address %Common . Atts ; 

IS03166 NMTOKEN #REQUIRED> 

<! ELEMENT street EMPTY> 

<!-- The type can be street, lane, avenue, Gasse... 

compl is a complementary description --> 

<!ATTLIST street number CDATA #IMPLIED 

type CDATA # IMPLIED 

name CDATA # IMPLIED 

compl CDATA #IMPLIED> 

< ! ELEMENT imm (# PCDATA) > 

< ! ELEMENT city ( # PCDATA ) > 

< ! ELEMENT CP (# PCDATA) > 

< ! ELEMENT state (# PCDATA) > 

<!ATTLIST state code NMTOKEN #IMPLIED> 

<!-- satus applies to email addresses, telephons and so on. 

Values are "perso" personal and "prof" prof essional . 

<! ENTITY % coordAttrib 

'status (perso I prof) "perso" 
descr CDATA # IMPLIED 

value CDATA #REQUIRED'> 

<!-- Coordinates group elements such as URLs, emails, 
mobile phones --> 

<! ELEMENT coords (URL | email | tel ) *> 

<!ATTLIST coords ID ID #REQUIRED> 

<! ELEMENT email EMPTY> 

<!-- The attributes can be used to generate address books 
for mailers such as mutt or pine --> 

<!ATTLIST email 

%coordAttrib; 
name CDATA # IMPLIED 

alias CDATA #IMPLIED 

fee CDATA #IMPLIED> 

<! ELEMENT URL EMPTY> 

<!ATTLIST URL %coordAttrib; 

name CDATA #IMPLIED> 

<! ELEMENT tel EMPTY> 

<!ATTLIST tel %coordAttrib; 

type ( f ix |mobile 1 f ax) "fix" 

IS03166 NMTOKEN #IMPLIED> 

<! ELEMENT organism (address* , coords? ) > 

<!ATTLIST organism ID ID #IMPLIED 
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name CDATA # IMPLIED 

sigle CDATA # IMPLIED 

address IDREF # IMPLIED 

coords IDREF # IMPLIED 

criteria CDATA #IMPLIED> 

< ! ELEMENT person EMPTY> 

<!-- The attributes are patronymic, name, f(irst) name, 

nickname, address, coords, criteria is not used yet --> 
<!ATTLIST person ID ID #IMPLIED 

patronymic CDATA # IMPLIED 

name CDATA # IMPLIED 

fname CDATA # IMPLIED 

nickname CDATA # IMPLIED 

address IDREF #IMPLIED 

coords IDREF #IMPLIED 

criteria CDATA #IMPLIED> 

<! ELEMENT entries ( entry* )> 

< ! ELEMENT entry ( %Correspondant ; ) > 

<!-- An entry has two attributes: 

sortargument says which attribute of the children 
person or organism is used as a sort argument 
(name, nickname...) alpha is the first letter of 
the sort argument and will be used to select the 
entries --> 

<!ATTLIST entry 

sortargument CDATA # IMPLIED 

alpha CDATA #IMPLIED> 

<! ELEMENT addresses (address*) > 

<! ELEMENT coordinates (coords*) > 

A sample XML file following the DTD. 

<?xml version=" 1 . 0 " encoding=" iso-8859-1 " ?> 

< ! DOCTYPE annuvrac SYSTEM " . /annuaire . dtd" > 

<annuvrac> 

<person ID=" joneswilliam" 

patronymic=" Jones " fname= "William" 
nickname="Bill" address=" AD-01" /> 

<address ID="AD-01" IS03166="US"> 

<street number= " 3152 " name= "Westview Dr App 105" /> 
<city>Austin</city> 

<CP>77055</CP> 

<state>Texas</state> 

<tel status="perso" type="fix" IS03166="US" 
value=" (0)01.589.365.5789" /> 

</address> 

<person ID= " schaf f eWerner " 

patronymic=" Schaffer" 
f name = " We r ne r " 
address= "AD-03 " /> 

<address ID="AD-03" IS03166= "DE"> 

<street number="31" 
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type= " Strasse " 
name="Landgraf Karl" /> 

<c i ty>Coburg< / c i ty> 

<CP>66540</CP> 

</address> 

<person ID="Lej eunebeatrice-ID-00 " patronymic="Lejeune" 
name="Saar" fname= "Beatrice " 
nickname = "Milou" address= "AD- 04 " 
coords="CD-04 " /> 

<person ID= " saarfranz-ID-00 " patronymic= " Saar " 

fname= " Franz " address= "AD-04 " coords=" CD-041" /> 

<address ID="AD-04" IS03166="FR"> 

<street number="28" type="rue" name= " Sainte-Beuve" /> 

<c i ty>Bordeaux< / c i ty> 

<CP>33000</CP> 

<tel status="perso" type="fix" IS03166="FR" 
value="2.42.61.99.00" /> 

</address> 

<coords ID=" CD-04 "> 

<tel status= "perso" type="mobile" IS03166="FR" 
value="06.78.35.69.15" /> 

<email status= "prof " value="elejeune@fr. ibm.com" /> 

<email status= "perso" value= " saar-le j eune . eQfree . fr " /> 

</coords> 

<coords ID="CD-041"> 

<email status= "perso" value=" f saar@free . de" /> 

</coords> 

<person ID= "bosvendsen" patronymic= " Svendsen" fname="Bo" 
address= "AD-08 " nickname= " Ragnar " coords= "CD-08 " /> 

<address ID="AD-08" IS03166="SV"> 

<street number="28" type="gata" 

name="Carl Michael Bellmans" /> 

<city>Uppsala</city> 

</address> 

<coords ID=" CD-08 "> 

<tel status="perso" type="fix" IS03166="FR" 
value="08.63.58.98.12" /> 

<email status= "perso" value="vsv®telia . com" /> 

</coords> 

</annuvrac> 

The document above is transformed in a custom way into another one that makes for- 
matting easier. The example has been developed for processing with OpenJade, an 
OpenSource tool that doesn’t support the transformation language, but has a custom 
transformation language implemented. The result of this transformation process is the 
document below. 

<?xml version=" 1 . 0 " encoding= " iso-8859-1 " ?> 

<!D0CTYPE annuedit SYSTEM " annua ire . dtd" > 
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<annuedit> 

<entries> 

<entry alpha="B" sortargument= " fname" > 

<person fnarr\e= "Beatrice" name="Saar" 
patronymic= " Le j eune " 

nickname="Milou" address= " AD-04 " coords="CD-04 " /> 

</entry> 

<entry alpha="B" sortargument= "nickname " > 

<person fname= "William" patronymic= "Jones " 
nickname= "Bill " address= "AD-01 " /> 

</entry> 

<entry alpha="B" sortargument= " fname" > 

<person fname="Bo" patronymic= " Svendsen" 
nickname= " Ragnar " 

address= "AD-08 " coords="CD-08" /> 

</entry> 

<entry alpha="F" sortarg\iment= " fname" > 

<person fname= "Franz " patronymic= " Saar " 

address= "AD-04 " coords="CD-041 " /> 

</entry> 

<entry alpha="J" sortargument= "patronymic " > 

<person patronymic= "Jones " fname= "William" 
nickname="Bill" address= "AD-01 " /> 

</entry> 

<entry alpha="L" sortargument= "patronymic " > 

<person patronymic="Lejeune" name="Saar" 
fname= "Beatrice" nickname="Milou" 
address= "AD-04 " coords="CD-04 " /> 

</entry> 

<entry alpha="M" sortargument=" nickname "> 

<person fname= "Beatrice" name="Saar" 

patronymic= "Lejeune" nickname= "Milou" 
address= "AD-04 " coords= "CD-04 " /> 

</entry> 

<entry alpha="R" sortargument=" nickname "> 

<person fname="Bo" patronymic= " Svendsen" 
nickname= "Ragnar" address="AD-08 " 
coords= "CD-08" /> 

</entry> 

<entry alpha="S" sortargument="name"> 

<person name="Saar" patronymic=" Lejeune" 
f name = "Beatrice" nic kname = " M i 1 ou " 
address= "AD-04 " coords="CD-04 " /> 

</entry> 

<entry alpha="S" sortargument= "patronymic " > 

<person patronymic= " Saar " fname= "Franz " 

address= "AD-04 " coords= "CD-041 " /> 

</entry> 

<entry alpha="S" sortargument= "patronymic "> 
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<person patronymic=" Schaffer" f name = "Werner " 
address= "AD-03 " /> 

</entry> 

<entry alpha="S" sortargument= "patronymic "> 

<person patronymic= " Svendsen" fname="Bo" 
nickname= "Ragnar" address= "AD-08 " 
coords="CD-08" /> 

</entry> 

<entry alpha="W" sortargument= " fname" > 

<person fname= "Werner " patronymic= " Schaffer " 
address= "AD-03 " /> 

</entry> 

<entry alpha="W" sortargument= " fname" > 

<person fname= "William" patronymic= "Jones " 
nickname= "Bill " address= "AD-01 " /> 

</entry> 

</entries> 

<addresses> 

<address ID= "AD-01" IS03166="US"> 

<street number= " 3152 " name= "Westview Dr App 105" /> 
<city>Austin</city> 

<CP>77055</CP> 

<state>Texas</state> 

<tel status= "perso" value=" (0) 01 .589 .365 .5789" 
type="fix" IS03166="US" /> 

</address> 

<address ID="AD-03" IS03166= "DE" > 

<street number="31" type= " Strasse " 
name="Landgraf Karl" /> 

< c i ty>Coburg< / c i ty> 

<CP>66540</CP> 

</address> 

<address ID= "AD-04" IS03 166= " FR" > 

<street number="28" type="rue" name="Sainte-Beuve" /> 
<c i ty>Bordeaux< / c i ty> 

<CP>33000</CP> 

<tel status= "perso " value= " 2 . 42 . 61 . 99 . 00 " type="fix" 
IS03166="FR" /> 

</address> 

<address ID= "AD-08" IS03166="SV"> 

<street number="28" type="gata" 
name="Carl Michael Bellmans" /> 

< c i t y >Upp sala</ci ty > 

</address> 

</addresses> 

<coordinates> 

<coords ID=" CD-04 "> 

<tel status="perso" value= " 06 . 78 . 35 . 69 . 15 " 
type= "mobile " IS03166="FR" /> 

<email status= "prof " value="elejeune@fr . ibm. com" /> 
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<email status="perso" 

value="saar-lejeune . e@free . fr” /> 

</coords> 

<coords ID="CD-041"> 

<email status= "perso" value= " f saar@f ree . de " /> 
</coords> 

<coords ID= "CD-08 "> 

<tel status="perso" value= " 08 . 63 . 58 . 98 . 12 " type="fix" 
IS03166="FR" /> 

<email status= "perso" value= " vsv@telia . com" /> 
</coords> 

</coordinates> 

</annuedit> 

And here comes the DSSSL code. 

<style-specif ication> 

(define if-f irst-page 
( external -procedure 

"UNREGISTERED: : James Clark/ /Procedure : : if-f irst-page" ) ) 

; ; The date on the phone book is given at run time 
(define DSSSLdate "No date") 

; ; ; ; Formatting of the ouput ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; 
; ; Fonts 

( de f ine * textFontFami ly * *propFontFami ly * ) 

(define *propFontFamily* "Arial") 

(define *f ixedFontFamily* "Courier") 

(define *nameFontSize* 14pt) 

(define *textFontSize* 12pt) 



Formatting of pages 
Margins 



(define 


*lef t-margin* 


4cm) 


(define 


*right-margin* 


2cm) 


(define 


*top-margin* 


3cm) 


(define 


*bot tom-margin* 


2cm) 


; ; Header and footer 




(define 


* footer-margin* 


1cm) 


(define 


*header-margin* 


1 . 5cm) 


; ; Starting indentations 




(define 


* start- indent* 


2cm) 



(define *f irst-line-start-indent* -1cm) 

; ; Spacing 

(define *space-af ter* *textFontSize* ) 

(define *line-spacing* *textFontSize* ) 

(define *f irst-line-indent* 1cm) 

; ; Paragraphes 

(define *orphan-count* 20) 

(define *widow-count* 20) 
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; ; ; ; ; ; ; ; ; ; ; ; Rules ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; 

; Annuedit is the root of the document. It contains 
; entries, addresses and coordinates. 

(element annuedit (process-children) ) 

; Adresses and coordinates are not directly processed. 

; Their processing is triggered by the one of entry elements 
; whose children link to them. 

(element addresses (empty-sosof o) ) 

(element coordinates (empty-sosof o) ) 

; The entries are processed using a loop: 

; For each letter, the correspondants (person and 
; organism) whose first letter (alpha attribute) is 
; equal to the letter are selected and processed by 
; the function alphannu. 

(element entries 
; The loop uses two arguments : 

; - a string containing a letter ("A", "B"..."Z") 

; - a sosofo containing the concatenbation of the 

; result of the processing of the entry elements 

; whose attribute alpha is one of the previous 

; letters. 

; For each iteration, the first element (car alpha) of the 
; list of letters is processed and the result of the 
; processing a node list of entry elements 

(let loop ((alpha (list "A" "B" "C" "D" "E" "F" "G" "H" 

"I" "j" "K" "L" "M" "N" "0" "P" 

MQ,. Mg.. ..-pn uu" "V" "W" "X" 

"Y" "Z" )) 

(result (empty-sosofo) ) ) 

(if (equal? alpha '()) 
result 

(loop (cdr alpha) 

(sosofo-append 

result 

(let ((letter (car alpha))) 

(alphannu 

letter 

(select -elements 

(children (current-node) ) 

'(entry ("alpha" letter)))))))))) 

; This rule has the same result as the rule for entries, 

; but does not use a loop. 

(element entries-example-rule 
(sosofo-append 

(alphannu "A" (select-elements (children (current -node) ) 

'(entry ("alpha" "A")))) 

(alphannu "B" (select-elements (children (current-node)) 

'(entry ("alpha" "B")))) 

; ; from C to Y ... 

(alphannu "Z" (select-elements (children (current -node) ) 

'(entry ("alpha" "Z")))))) 
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; entry elements are used to order and duplicate the person 
; and organism elements. Their children are directly 
; processed. 

(element entry (process-children) ) 



(element person 

(let* ( (sort argument (attribute-string 

" sortargument " 

(parent (current-node) ) ) ) 

(fname (attribute-string "fname")) 

(name (attribute-string "name")) 

(patronymic (attribute-string "patronymic")) 

(nickname (attribute-string "nickname")) 

; ; The booleans are true if the attribute is used as sort 
; argument 

(fname? (equal? sortargument "fname")) 

(name? (equal? sortargument "name")) 

(patronymic? (equal? sortargument "patronymic")) 

(nickname? (equal? sortargument "nickname"))) 



; Each person is used to produce a display-group. 

(make display-group keep: #t 
(sosof o-append 
(parag- identity 

; The parameters for parag- identity depends on the sort 
; argument . 

; If name and patronymic are present AND different, 

; they are written as follows: 

; FirstName Patronymic (Name) 

; Name FirstName [Patronymic] 

; Patronymic FirstName (Name) 

; The sort argument is written first 
(cond 

(fname? (literal 

fname " " 

; f -string returns the concatenation the parameters if 
; the second one is a string 
; and the empty string in the other cases. 

(f -string "" patronymic "") 

II II 

(if (not (equal? name patronymic)) 
(f-string "(" name ")") 

" "))) 



(name? (literal 

name " " 

(f-string "" fname "") 

(if (not (equal? name patronymic) ) 
(f-string " [" patronymic "]") 

" "))) 



(patronymic? (literal 

patronymic " " 

( f-string " " fname " " ) 

(if (not (equal? 

name 

patronymic) ) 
(f-string " (" name ")") 
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" "))) 

; The nickname is written in italic 

(nickname? (sosofo-append 

(make sequence 

font-posture: 'italic 

(literal nickname) ) 

; followed by "more regular" names 

(literal 

II ^ II 

(f -string "" fname " ") 
(f-string "" patronymic " ") 
(f -string "" name "") 
"]"))))) 

; This triggers the processing address 

(parag-address (attribute-string "address")) 

; and of coordinates (note: (current-node is default 

; argument) in (attribute- string...) 

(parag-coord (attribute-string "coords")))))) 

(element organism 

(let* (( sort argument (attribute-string 

" sortargument " 

(parent (current-node) ) ) ) 

(sigle (attribute-string "sigle")) 

(name (attribute-string "name")) 

(sigle? (equal? sortargument "sigle")) 

(name? (equal? sortargument "name"))) 

(make display-group keep: #t 
(sosofo-append 
(parag- identity 
(cond 

(sigle? (literal 

(f-string "" sigle "") " " 

(f-string "" name "") " ")) 

(name? (literal 

(f-string "" name "") " " 

(f-string "[" sigle "]") 



(parag-address (attribute-string "address")) 
(parag-coord (attribute-string "coords")))))) 

; ; This rule is not reached using the process-children 
; because of the rule on addresses 
(element address 
( sosofo-append 

; the processing of address is redirected to another mode 
(with-mode address 

(process-node-list (current -node) ) ) 

(process -node-list 

(select-elements (children (current-node)) 'tel)) 
(make paragraph-break) ) ) 



(element coords 
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(process-children) ) 

(element tel 

( sosof o-append 

(literal (f-phone (current-node))) 

(make paragraph-break) ) ) 

(element email 

(f-emailURL (current-node))) 

(element URL 

(f-emailURL (current-node))) 

;; The f-functions format the content of element tel, 

; email and URL 
(define (f-phone snl) 

; The attribute strings are loaded in variables 
(let ((type (attribute-string "type" snl)) 

(status (attribute-string "status" snl) ) 

(value (attribute-string "value" snl) ) 

(descr (attribute-string "descr" snl) ) ) 

( string-append 
; Is it a mobile? 

(if (and (equal? type "fix") 

(equal? status "perso")) 

"tel" 

(string-append 
; Or a fax? 

(if (equal? type "fax") 

" fax " 

" ") 
status) ) 

II . II 

(attribute-string "value") 

(f-string "(" descr ")")))) 

; ; email and URL are processed the same way. 

; The label is calculated from th gi (general identifier) 
(define (f-emailURL snl) 

(let ((status (attribute-string "status" snl)) 

(value (attribute-string "value" snl) ) 

(descr (attribute-string "descr" snl) ) ) 

(sosof o-append 

(literal (if (equal? (gi snl) "URL") 

" URL " 

(if (equal? (gi snl) "email") 

" @ " 

" ? ? ? " ) ) 

status " : " value 
(f-string " (" descr ")")) 

(make paragraph-break) ) ) ) 

; ; The mode address is used for formatting the addresses 
(mode address 

(element address 

; ; This rule orders the components of address on lines 
; booleans values trigger a paragraph-break 
(let* ((IS03166 (attribute-string 




Chapter 7 . The Style Process 



297 



( iitim 

( imm? 
(city 

(city? 

(street 



(CP 

(CP? 

(state 

( state? 
(country 

(country? 



"IS03166" 

(current-node) ) ) 

(select-elements 

(children (current-node)) 'imm)) 

(not (node-list-empty? imm) ) ) 

(select- elements 

(children (current-node)) 'city)) 
(not (node-list-empty? city) ) ) 
(select-elements 

(children (current-node)) 'street)) 
(street? 

(not (node-list-empty? street) ) ) 
(select-elements 

(children (current-node)) 'CP)) 

(not (node-list-empty? CP) ) ) 
(select-elements 

(children (current-node)) 'state)) 
(not (node-list-empty? state) ) ) 

(select -elements 

(children (current-node)) 'country)) 
(not (node-list-empty? country) ) ) ) 



(me f- address 
(cond 

((equal? IS03166 "GB") 

(list imm imm? 

street street? 
city city? 

CP CP? 

(isocode IS03166) ) ) 



((equal? IS03166 "US") 

(list imm imm? 

street street? 

city state CP (or city? state? CP?) 
(isocode IS03166))) 



((equal? IS03166 "SV") 

(list imm imm? 

street street? 
city CP (or city? CP?) 

(isocode IS03166) ) ) 

; ; More common ordering of address elements 
(else 

(list imm imm? 

street street? 

CP city (or city? CP?) 

(isocode IS03166) ) ) ) ) ) ) 

;; Orders the components of street on aline, according 
; to national usages. 

; WORK: Perhaps not suited to countries with more than 
; one national language (CH, BE, FI...) 

(element street 

(let ((IS03166 (attribute-string 
"IS03166" 

(parent (current-node) ) ) ) 

(compl (attribute-string "compl")) 

(type (attribute-string "type")) 
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(number (attribute-string "number")) 
(name (attribute-string "name"))) 

(make sequence 
(cond 



( (equal? 


IS03166 


" ES " ) 


(literal 












( f-string 


"" type " 


") 








( f-string 


" " name " 


”) 








(f-string 


" " number 


" ") 








(f-string 


" " compl " 


■') ) ) 


( (equal? 


IS03166 


"DE" ) 


(literal 












(f-string 


" " name " 


") 








(f-string 


"" type " 


") 








( f-string 


" " number 


.. 








(f-string 


" " compl " 


"))) 


( (equal? 


IS03166 


" SV") 


(literal 












( f-string 


" " name " 


") 








( f-string 


"" type " 


’’) 








(f-string 


" " number 


" ") 








( f-string 


" " compl " 


") ) ) 


(else 






(literal 












(f-string " 


" number " 


") 








(f-string " 


" type " " 


) 








(f-string " 


" name " " 


) 








(f-string " 


" compl " 


" ) ) ) ) 



; ; The six following elements are printed with a trailing 
; space 

(element imm 



( sosof o-append 


(process -children- trim) 


(literal " 


' "))) 


(element CP 

(sosof o-append 


(process -children- trim) 


(literal '' 


' "))) 


(element city 
( sosof o-append 


(process -children- trim) 


(literal " 


' "))) 


(element state 
( sosof o-append 


(process -children- trim) 


(literal " 


' "))) 


(element country 
(sosof o-append 


(process -children- trim) 


(literal '' 


' "))) 



; / ; ; End of mode address ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; 

; ; Functions ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; ; 

; Return the name of a country given the IS03166 code 
(define (isocode IS03166) 

(cond 



( (equal? 


IS03166 "ES") 


" Spain" ) 


( (equal? 


IS03166 "FR") 


"France" ) 


( (equal? 


IS03166 "GB") 


"United Kingdom" 


( (equal? 


IS03166 "US") 


"USA" ) 


( (equal? 


IS03166 "DE") 


" Germany " ) 


( (equal? 


IS03166 "SV") 


" Sweden" ) 
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; ; Unknown code 

(else (string-append "IS 03166 : " 

IS 03166 ) ) ) ) 

; Return the string param enclosed between left and right 
; return "" if param is not a string 
(define (f-string left param right) 

(if (string? param) 

(string-append left param right) 

....)) 



; ; Format the addresses 

; param is a list of node-list, strings and booleans 
; node-lists are processed 
; strings are outpput in (literal ...) 

; #t true) triggers a paragraph-break 

; #f true) triggers an empty-sosofo 

(define (mef-address param #!optional (snl (current-node))) 
(let loop ((tokens param) 

(resultat (empty-sosofo) ) ) 

(if (equal? tokens '()) ;; end of the list 

( sosof o-append 
resultat 

(make paragraph-break) ) 

(loop (cdr tokens) 

( sosof o-append 
resultat 

(let ((token (car tokens))) 

(cond 

( (equal? token #t) 

(make paragraph-break) ) 

( (equal? token #f ) 

(empty-sosofo) ) 

( (node-list? token) 

(wi th-mode address 

(process-node-list token) ) ) 

(else 

(literal token) )))))))) 



; ; The parag-xx functions format the parts of each entry 
; ; in the phone bbok . 

7 ; There are three parts : 

; ; identity 

77 address (if any) 

77 this is the "physical" address 

7 7 with street name, phone number 

7 7 etc . . . 

77 coords (if any) 

7 7 the coords are such information 

7 7 which are not bound to 

7 7 a physical address 

77 (cell-phone, URL, email etc...) 

7 7 Each of these parts is printed in a paragraph 
(define (parag-identity identity) 

(make paragraph start-indent: *start-indent* 
space-before: * textFontSize* 
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space-after: 0cm 

first-line-start- indent : * first- line- star t- indent * 
line-spacing: *textFontSize* 
font -f ami ly-name : *propFontFamily* 
font-weight: 'bold 

font-size: *nameFontSize* 
orphan-count: *orphan-count* 
widow-count: *widow-count* 
keep-with-next? : #t 

identity) ) 

; Build a paragraph using the element whose id is the 
; parameter 

(define (parag-address address) 

(if (string? address) 

(make paragraph start-indent: *start-indent* 
space-after: 0cm 
line-spacing: *textFontSize* 
font -f ami ly-name : *propFontFamily* 
font-size: *textFontSize* 
orphan-count: *orphan-count* 
widow-count: *widow-count* 
keep-with-next?: #t 

; fetch the element address linked through IDREF attribute 
(process-element-with-id address) ) 

(empty-sosofo) ) ) 

; ; Build a paragraph using the element whose id is the 
; parameter 

(define (parag-coord coords) 

(if (string? coords) 

(make paragraph start-indent: *start-indent* 
space-after: 0cm 
line-spacing: *textFontSize* 
font -family-name : *propFontFamily* 
font-size: *textFontSize* 
orphan-count: *orphan-count* 
widow-count: *widow-count* 

; fetch the element coords linked through IDREF attribute 
(process-element-with-id coords) ) 

(empty-sosofo) ) ) 



;; Build a simple page sequence for each pair of parameters: 
; letter is a string containing a letter. 

; snl is a node list containing the entry elements whose 
; attribute alpha contains letter and which will be 

; output in the the simple -page -sequence 

(define (alphannu letter snl) 

(make simple-page-sequence 

left-margin; *lef t-margin* 
right-margin: *right-margin* 
top-margin: *top-margin* 

bottom-margin: *bottom-margin* 
left-header: (empty-sosofo) 

letter will appear on top of the first page 
center-header: ( if -first-page 

(make sequence 

font -family-name : *propFontFamily* 
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right-header 
header-margin 
left-footer 
center- footer 



font-size: (* *textFontSize* 3) 

(literal letter)) 

(empty-sosofo) ) 

(empty-sosofo) 

*header-margin* 

(empty-sosofo) 

(make sequence 

f ont- family- name : *propFontFamily* 
font-size: * textFontSize* 



^iicerai jJt»t»t»Liaai:e 
right-footer: (empty-sosofo) 

footer-margin: * footer-margin* 
font -f ami ly-name : *propFontFamily* 
font-size: * textFontSize* 
input-whitespace-treatment : ' collapse 
quadding: 'start 
(process-node-list snl) ) ) 






</style-specif ication> 



7.6. Catalog of Flow Object Classes 

In the table below, the flow object classes are summarized. For each class its name is 
shown, its type (D (displayed) or I (inline)), its ports and the objects accepted by the 
ports (their names or their type (D or I)). When the type of a flow object class is neither 
D nor I, it means it is a root object. In some cases a parent or an ancestor is required. 

Table 7-107. Flow Object Classes 



class 


D/I 


ports 


subobjects 


ancestor 


sequence 


D/I 


#f 


D/I 




display-group 


D 


#f 


D 




simple-page- 

sequence 


- 


#f 


D 




page-sequence 


- 


page-model 


column-set-sequence, ^D? 




column-set-sequence 


D 


top-float, body- 
text, bottom- 
float, footnote 


D/I 


page- 
sequence, 
colunrn- set- 
sequence 


paragraph 


D 


#f 


D/I 




paragraph-break 


D 


- 




paragraph 


line-field 


I 


#f 


I 




sideline 


D 


#f 


D/I 
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Table 7-107 (cont.). Flow Object Classes 



class 


D/I 


ports 


subobjects 


ancestor 


anchor 


D/I 


- 






character 


I 


- 






leader 


I 


#f 


I 




embedded-text 


I 


#f 






rule 


D/I 


- 






external-graphic 


D/I 


- 






included-container- 

area 


D/I 


#f 


D 




score 




#f 


I 




box 


D/I 


#f 


D/I 




side-by-side 


D 


#f 


side-by-side-item 




side-by- side-item 


D 


#f 


D 


side-by-side 


glyph-annotation 




#f, annotation 


character, character 




alignment-point 


I 


- 




paragraph 


aligned-column 


D 


#f 


D 




multi-line-inline-note 


I 


#f 


I 




emphasizing-mark 










math-sequence 


D/I 


#f 


math-sequence, 
unmath, subscript, 
superscript, script, mark, 
fence, fraction, radical, 
math-operator, grid, 
character, alignment-point 




unmath 


I 


#f 


I 




subscript 




#f 






superscript 




#f 






script 


D/I 


#f, pre-sup, pre- 
sub, post- 
sup, post- sub, mid- 
sup,mid-sub 


math-sequence, 
unmath, subscript, 
superscript, script, mark, 
fence, fraction, radical, 
math-operator, grid, 
character, alignment-point 
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Table 7-107 (cont.). Flow Object Classes 



class 


D/I 


ports 


subobjects 


ancestor 


mark 


D/I 


#f, over-mark, 
under-mark 


math-sequence, 
unmath, subscript, 
superscript, script, mark, 
fence, fraction, radical, 
math-operator, grid, 
character, alignment-point 




fence 


D/I 


#f, open, close 


math-sequence, 
unmath,subscript, 
superscript, script, mark, 
fence, fraction, radical, 
math-operator, grid, 
character, alignment-point / 
character / character 




fraction 


D/I 


numerator, 

denominator 


math-sequence, 
unmath, subscript, 
superscript, script, mark, 
fence, fraction, radical, 
math-operator, grid, 
character, alignment-point 




radical 


D/I 


#f, degree 


math-sequence, 
unmath, subscript, 
superscript, script, mark, 
fence, fraction, radical, 
math-operator, grid, 
character, alignment-point 




math-operator 


D/I 


#f, operator, 
lower-limit, 
upper-limit 


math-sequence, 
unmath, subscript, 
superscript, script, mark, 
fence, fraction, radical, 
math-operator, grid, 
character, alignment-point 




grid 


D/I 


#f 


grid-cell 




grid-cell 


I 


#f 


math-sequence, 
unmath, subscript, 
superscript, script, mark, 
fence, fraction, radical, 
math-operator, grid, 
character, alignment-point 




table 


D 


#f 


table-part/table-column, 
table-row, table-cell 
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Table 7-107 (cont.). Flow Object Classes 



class 


D/I 


ports 


subobjects 


ancestor 


table-part 




#f/header/footer 


table-column, table-row, 
table-cell/table-row, 
table-cell/table-row, 
table-cell 




table-column 




- 






table-row 




#f 


table-cell 


table-part, 

table 


table-cell 




#f 


D 


table-row, 

table, 

table-part 


table-border 




- 




table, 

table-border 


scroll 


- 


#f 


D 




multi-mode 


D/I 


modes 






link 


I 


#f 


D/I 




marginalia 




#f 


I 


paragraph 




Appendix A. Tools Supporting 
DSSSL 



There are two main tools supporting DSSSL. One is a commercial tool, the other is an 
OpenSource tool. 



A.1. DSSSLprint 

DSSSLprint2.0, by NEXT SOLUTION CO., LTD., is a core UNIX server engine using 
DSSSL stylesheets. More information on this tool can be found in 

http://www.nextsolution.co.jp/English 

or by email at <sales@nextsolution . co . jp>. 

A.1.1. Description 

DSSSLprint is the only commercial DSSSL formatting engine of the server type in the 
world. After several years of development, it has accomplished acceptation from the 
Japan Patent Office, and also Sony and Sharp companies. This achievement ensures that 
the tool can provide high speed, high quality and stable SGML/XML document man- 
agement solution and technology for enormous volume of output electric documents 
and forms, which is the core of a backbone information system toward customers. 

This UNIX engine has been successfuly run on basic UNIX server environments such 
as SUN Solaris 2.5/2.6, 7/8, SPARC/Ultra workstation or server, and HP.UX 11.0, 
PA.RISC workstation or server. 
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It supports PS and PDF native output as basic format of print and data management. It 
also has a bookmarker option. 

Due to the fact that DSSSLprint2.0 is a core engine of the system, there is a simple 
interface and flexible options by command line. It can also be easily customized to the 
user needs, altering methods, keywords or default values. 

The formatting level is adequate enough for information documentation, although not 
for desktop publishing layout. The engine conforms to Docbook and ISO TR 9573-11 
2nd edition DTD. 

The tool supports the full page feature, along with the advanced formatting options 
related to it, like flow object syncronization and column designs. Some graphical ex- 
amples of capabilities of the tool are below. 

Example A-1. Images flowed in 4 different regions 




fig 




fig 


paragraph 









Example A -2. Footnotes flowed with referring page 



paragraph 






*1 


.... 


















*1 
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Example A-3. Two-page spread layout with synchronization of side-note 



*1 .. 


paragraph 


..*1 





















On the level of Flow Object Classes, DSSSLprint supports page- sequence/column- set- 
sequence. It means that DSSSLprint can express multiple columns with designated 
page order. This level of layout covers most manual and information documentation. 

Example A -4. Page layout using page-sequence/column-set-sequence 



COVER 

PAGE 



Author 



Title.. 




INDEX 

Page 



* 

* 



A.1 .2. Automatization and Process Flow 

Desktop Publishing software is able to create complicated layout by its interactive op- 
eration, however 

• If more than some 10,000 output pages should be formatted 

• If the output is not a complicated layout like application forms 
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• If the changes in layout is about less than 20 % 

automatic formatting has more advantages in time and expenses. A customer may se- 
lected automatic formatting (DSSSL) over Desktop Publisnihg software due to neces- 
sity of layout and amount according to the 3 conditions above. 

As already discussed, DSSSL is an International Standard which is standarized with a 
support for a lot of countries aspects. Therefore, DSSSL has ingredient of CJK (Chi- 
nese, Japanese, Korean) languages. Due to this advantages, the customer can obtain 
better CJK layout than with other options. 

The processing is performed by the server. Therefore, after sending data to the server 
clients are able to work on other tasks. Especially, processing large amount of data 
(hundreds and thousands of pages) produces the result with high effectiveness. 

Even if multiple files are sent to server, ascertainment of status and abort of process are 
easily operated by GUI. 

Clients do not have to understand how to use DSSSLprint (facility of the system). 
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Figure A-1. Process Flow 
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1. Clients select needful XML (in this XML there is information of what kind of 
forms should be used), then send to the system. 

2. The system receives orders from a lot of clients and manages all of them in the 
queue. 

3. The XML which popped out from queue is formatted in DSSSLprint with the 
specified style-sheet. 

4. The result is created with the format (PDF, PS, XML) specified by the clients. 

5. Outputs are managed by the output queue. 

Outputs are sent to the chosen printer for printing or server for storing information as 
user specification. 
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A.1 .3. Level of Coverage of DSSSL 

A good way to describe the level of coverage of DSSSL by part of a tool is describing 

the features supported by the tool. 

• Supported features, keyword, expression, sideline, vertical, table, simple-page, 
page, multi-column, actual-characteristic, cross-reference. 

• Parcially supported features, math, table-auto- width 

• Unsupported features, combine-char, multi- source, regexp, word, hytime, query, 
side-by-side, aligned-column, bidi, nested-column, general-indirect, inline-note, 
glyph-annotation, emphasizing-mark, included-container, online, font-info. 



A.1.4. Extensions over the Standard 

Next Solution had extended the DSSSL standard due to their customer needs. The 
following are the existing extensions. 

A.1.4.1. Line-field 

Table A-1. Extended Characteristics of line-field 



Characteristic 


Inh 


Values 


Default 


Explanation 


inhibit-justify- 

space 


N 


(before | after | 
both 1 #f) 


#f 


Inhibits generating quadding : 
'justify space before/after the 
field. 



(element If 

(make line-field 
field-width: 500pt 
inhibit- justify-space : 'both)) 



A.1.4.2. Link 

The extensions are oriented to add bookmarks on PDF files when link flow objects are 
formatted. 

Table A-2. Extended Characteristics of link 



Characteristic 


Inh 


Values 


Default 


Explanation 


bookmark? 


N 


(#ti#f) 




Specifies whether bookmarks are 
generated. 


bookmark-level 


N 


Number 


0 


Specifies the bookmark level. 


bookmark-title 


N 


String 


"" 


Specifies the bookmark title. 



(element bookmark 
(make link 

bookmark?: #t 

bookmark- 1 eve 1 : (string->number (attribute-string "level")) 
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bookmark-title: (data (current-node))) 

(empty-sosofo) ) 

A.1.4.3. Display-group 

The extensions add characteristics similar to line-number : to display-group. 

Table A-3. Extended Characteristics of display-group 



Characteristic 


Inh 


Values 


Default 


Explanation 


ext-line-number 




style 




Specifies the style of 
the line number. 


ext-line-number- start 


N 


Number 


Must be 
specifiesd in 
declare- 
characteristic 


Specifies the starting 
number of line number. 


ext-line-number- 

position 




String 




Specifies position. If 
writing-mode is 
’left-to-right with 
simple-page-sequence, 
"1" is left side of main 
paragraph, "2" is right 
side of main paragraph. 
In a column- set with 3 
columns, if position is 
set as "3 4" both sides 
of 2nd column will 
have line-number. 


ext-line-number- 

interval 




Number 




Specifies a line 
numbering interval. If 
set to 3, starting from 
1, line-numbers are ’T 
4 7 10..." 


ext-line-number-sep 




length- spec 




Specifies the 
separation between 
line-number and 
display-area. 


ext-line-number- side 




(start I end ] both) 




Alternative way of 
setting position of 
line-number. Value is 
set in symbol among 
start, end, and both. 
Values of ext-line- 
number-position have 
higher priority. 
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(declare-characteristic ext- line-number- start 

"UNREGISTERED: :Next Solution/ /Characteristic : : ext -line-number- start " 1) 
(declare-characteristic ext- line-number- interval 

"UNREGISTERED: -.Next Solution/ /Characteristic : : ext-line-number-interval " 1) 
(declare-characteristic ext- line-number- side 

"UNREGISTERED: :Next Solution/ /Characteristic : : ext-line-number-side " 'end) 
(declare-characteristic ext- line-number- sep 

"UNREGISTERED: :Next Solution/ /Characteristic : : ext-line-number-sep" Opt) 
(declare-characteristic ext-line-number-position 

"UNREGISTERED; -.Next Solution/ /Characteristic ; : ext-line-number-position" "1") 
(element body 

(make display-group 
ext-line-number-position: "2" 
ext-line-number-interval: 1 
ext-line-number-sep: 20pt 
ext-line-number-side: 'end 
ext- 1 ine -number : (style 

font-size: 8pt 

font- family-name : "GothicBBB_Medium" 
ext-line-number-interval : 1) ) ) 



A.1.4.4. External-graphic 

The extensions are oriented towards the inhibition of expansion or reduction of the size 
of the image. 

Table A-4. Extended characteristics of external-graphic 



Characteristic 


Vaiues 


Explanation 


inhibit-expansion 


boolean 


If scale is ’max or ’max-uniform, this characteristics sets the 
image not to be expanded. 


Inhibit-reduction 


boolean 


If scale is ’max or ’max-uniform, this characteristic sets image 
not to be reduced. 



A.1.4.5. Sideline 

Extensions are oriented to move the line position at the attachment according to the 
relative coordinate system. 

Table A-5. Extended characteristics of sideline 



Characteristic 


Values 


Explanation 


sideline-shift 


length-spec 


Specifies the shift in the relative coordinates. 



(declare-characteristic side line- shift 

"UNREGISTERED; :Next Solution/ /Characteristic : : sideline-shift " Opt) 
(element change log 
(make sideline 

sideline-shift: 20pt) ) 
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A.1.4.6. Superscript 

Table A -6. Extended characteristics of superscript 



Characteristic 


Values 


Default 


Explanation 


superscript- 

height 


length- spec 


half length of 
font-size 


Specifies the height of the 
superscript. 



(element sub 

(make superscript 

superscript-height: 20pt) ) 



A.1.4.7. Subscript 



Table A-7. Extended characteristics of subscript 



Characteristic 


Values 


Default 


Explanation 


subscript-depth 


length- spec 


half length of font size. 


Specifies the depth of the 
subscript. 



(element sub 

(make subscript 

subscript-depth: 20pt) ) 

A.1.4.8. Common Characteristics of Dispiayed Objects 

Table A-8. Extended common characteristics 



Characteristic 


Values 


Explanation 


keep-with-next- 

line-count 


Number 


When a display flow object has keep-wi th-next ? : # t, 
and a number is specified, this flow objects will keep the 
number of line of next the paragraph. 


keep-line-count 


Number 


When a displayed flow object has keep ; (#t j 'page / 

' column-set / ' col umn ) , and a number is specified, this 
flow object will keep the number of line of next paragraph. 


keep-priority 


Number 


Specifies the priority of keep when keep-with-next and 
keep-with-previous occur in sequence. 



(element paratitle 
(make paragraph 

keep-with-next? : #t 
keep-with-next-line-count : 2 
keep: #t 

keep-line-count: 2)) 
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Table 7-107 (cont). Flow Object Classes 

A.1.4.9. Table-cell 

Table A-9. Extended characteristics of table-cell 



Characteristic 


Values 


Explanation 


cell-row-height 


Length-spec 


Specifies a height for the table-cell. 



(element td 

(make table-cell 

cell-row-height; 20pt) ) 



A.1 .4.1 0. Table-row 

Table A-10. Extended Characteristics of table-row 



Characteristic 


Values 


Explanation 


keep 


(#t 1 #f 1 page 1 column-set | 
column) 


Specifies a keep method for table-row. 



(element td 

(make table-row 
keep : #t) ) 



A.1. 4.11. Common Flow Object Characteristics 

Table A-11. Extended common characteristics 



Characteristic 


Values 


Explanation 


page-number-format 


String 


Specifies a format for page-number. 


(element doc 

(make simple-page-sequence 
page -number- format : " i " ) ) 
Page number format 
I, ii, Hi, iv, V, vi, vii, viii 


. , ix ... 


Table A-12. Extended common characteristics 


Characteristic 


Values 


Explanation 


Page-number-restart? 




Specifies that page-numbers must restart. 



(element doc 

(make simple-page-sequence: "i" 
page-number-restart?: #t) ) 
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Table A -13. Extended common characteristics 



Characteristic 


Values 


Explanation 


initial-page-number 


Number 


Specifies a starting page number. 



(element doc 

(make simple-page-sequence 
initial-page-number: 100)) 

Table A-14. Extended common characteristics 



Characteristic 


Values 


Explanation 


font-family-name 


’((language 
font-family-name) ...) 


Specifies multiple/mixture 
fonts according to language. 



(element para 
(make paragraph 

font- f ami ly-name : ' ( (EN "Helvetica") 

(JA "Gothic BBB") 

(CZ "MSMing")))) 

A.1.4.12. Column-set-sequence 

When ( balance ? # t ) is specified for the last page in a column- set, balance priority 
needs to be set to distinguish priority between keep and balance. 

Table A-15. Extended characteristics of column-set-sequence 



Characteristic 


Values 


Explanation 


balance-priority 


Number 


Number to distinguish priority between keep and 
balance. 



(def ine-column-set-model defcolumn-1 
(column- subset 
(balance? #t) 

(balance-priority 20) 

(flow (c-obj body text)) 

(column (width column-width) (x-origin 0mm) ) 

(column (width column-width) (x-origin (+ column-width column-sep) ) ) 



A.2. OpenJade 

OpenJade is the evolution of Jade, developed by James Clark. Now it has become an 
OpenSource tool and, as such, it is the result of the free cooperation of many individu- 
als, and is in constant development. For this reason, depending on when it is being read, 
the level of support will vary. The tool, in its present state, supports a limited fixed grove 
plan and the simple-page-sequence feature, although partial support for page feature is 
under development, and there are plans for a lot more future developments. 

Along the time several versions have seen the light. Many different improvements have 
been incorporated into it, and there are at the moment two versions: the official one, 
and a development one which has all the improvements but whose performance suffers 
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too much from the chaotic way those enhancements were incorporated. It is expected 
that the enhancements will be incorporated into the official version in short time. 

Due to the evolutive kind of tool that Open Jade is, this book will not spend pages 
explaining it, but will point some addresses on the web where the author can find a lot 
of information about the tool, and where the reader can offer his collaboration. 

• www.sourceforge.net/projects/openjade 

It is the main address where OpenJade is stored and maintained. 

• www.mulberrytech.com/dsssl 

It hosts the DSSSL users mailing list. 

• www.netfolder.com/dsssl 

It hosts information on DSSSL. 

• www.jclark.com 

It is the web page of James Clark, the original creator of Jade. 

As an OpenSource tool, OpenJade depends on the efforts of individuals, offered for 
free, with the aim of helping the community. The author of this book is an active col- 
laborator in the OpenJade community. OpenJade would benefit from your help. There 
is a lot to do. 
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indirect flow object, 216 

indirect sosofo, 215 

inexact quantity, 43 

inexact-> exact, 43 

inexact?, 43 

inherited characteristics, 267 
inherited-attribute-string, 1 23 
inherited-c, 190, 246 
inherited-element-attribute -string, 1 24 
initial processing mode, 192 
inline area, 181 
inline-note feature, 269 
inline-space, 253 
inline-space type, 253 
inline-space? , 253 
instabs module, 1 1 

(See Also SGML property set) 
integer, 36 
integer?, 37 

core expression language, 53 
intrinsic data type, ? 
intrinsic property, 57 
ipreced, 114 

K 

Kendot scoring, 259 
keyword, 35 
keyword-> string, 35 
keyword?, 35 

core expression language, 53 



L 

lambda, 14 
language type, 47 
language?, 48 

last-area-reference-value, 218 

last-preceding-area-reference-value, 218 

last-sibling?, 124 

layout order, 211 

leader, 222, 255 

length, 33 

core expression language, 53 
length-spec type, 200 
let, 20, 29 
let^, 21 
letrec, 21 

line-field, 233 
line-number, 221 
link, 281 
list, 33 

core expression language, 53 
list type, 31 
list->string, 50 
list-ref, 34 

core expression language, 53 
list-tail, 34 

core expression language, 53 
list?, 33 

core expression language, 53 
literal, 183 
log, 40 

M 

make, 176 
map, 29, 51 
map-constructor, 192 
marginalia, 283 
mark, 274 
match-element? , 128 
math feature, 271 
math-operator, 277 
math-sequence, 271 
max, 38 

core expression language, 53 
mayadd category, 62, 146, 171 
member, 34 

core expression language, 53 
merge-style, 188 
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min, 38 

core expression language, 53 
mode, 6, 191 
module, 57 
modulo, 39 

core expression language, 53 
multi-line-inline-note, 269 
multi -mode, 281 
multi-process feature, 187 
multi- source feature, 151 

N 

named let, 29 
(See Also let) 

named node list type, 57 105 
named-node, 105 
named-node-list-names, 105 
named-node -list-normalize, 105 
named-node -list ? , 105 
negative?, 38 
next -match. 111 
nmndlist type, 99 

(See Also named node list type) 
nodal data type, 57 
node type, 57 100 

(See Also singleton node-list) 
node list type, 57 
node -list, 100 
node-list type, 99 
node-list->list, 103 
node-list-address, 283 
node-list-contains? , 101 
node-list-count, 104 
node-list-difference, 101 
node-list-empty?, 100 
core query language, 120 
node-list-error, 104 

core query language, 121 
node-list-every?, 103 
node-list-filter, 103 
node-list-first, 100 
node-list-head, 104 
node -list-intersection, 101, 149 
node -list-last, 104 
node-list-length, 103 
node -list -map, 102 
node-list-no-order, 101 



node-list-property, 106 
node-list-reduce, 101 
node-list-ref, 104 
node-list-remove-duplicates, 101 
node-list-rest, 100 
node-list-reverse, 103 
node-list-some? , 102 
node-list-sublist, 104 
node-list-symmetric-difference, 1 02 
node-list-tail, 104 
node-list-union, 101 149 
node-list-union-map, 102 
node-list=?, 100 
node-list?, 100 

core query language, 121 
node-property, 106 
nonnodal data type, 57 
not, 31 

core expression language, 52 
notation, ? 

notation-generated-system-id, 126 
notation-public-id, 126 
notation-system-id, 126 
null?, 32 

core expression language, 52 
number type, 36 
number-> string, 42 

core expression language, 54 
number-indirect-sosofo, 219 
number?, 36 

core expression language, 53 

o 

odd?, 38 

online feature, 280 
OpenJade, 289 315 
optional category, 62, 146, 171 
or, 21 

origin, 109, 150 
origin-to-subnode-rel, 109 
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P 

page feature, 204, 214, 215, 222, 266 
page-model type, 207 
page-model?, 208 
page-number, 219 
page-number-in-node, 220 
page-number-sosofo, 202 
page-sequence, 204 
pair type, 31 
pair?, 31 

paragraph, 223, 233, 246 
externally aligned, 267 
paragraph-break, 230 
parent. 111, 150 

core query language, 121 
Pascal programming language, 25 
placement-path, 182 
placement-point, 182 
position-point, 182 
positive?, 38 
preced, 114, 149 
primary flow object, 219, 220 
prlgabsO module, 1 1 

(See Also SGML property set) 
prlgabsl module, 11 

(See Also SGML property set) 
procedure type, 51 
procedure?, 51 

core expression language, 54 
process-children, 8, 184, 
process-children-trim, 186 
process-element-with-id, 9, 186, 203, 
process-matching-children, 186 
process-node-list, 192 
propdef , 57 
property set, 56 
property -lookup, 116 

Q 

q-class, 129 
q-element, 129 
q-sdata, 130 
quantity type, 36 
quantity->number, 41 
quantity?, 36 

core expression language, 53 
quasiquote, 23, 24 



query, 6, 175 

query feature, 175, 192, 192, 283 
quote, 19, 22, 23, 24 
quotient, 39 

core expression language, 53 

R 

radical, 276 
real type, 36 
real?, 37 

core expression language, 53 
reduce, 29 
referent, 128 
regexp feature, 131 
regexp propset, 136 
regexp-and, 132 
regexp-node, 131 
regexp -opt, 133 
regexp-or, 132 
regexp-plus, 133 
regexp-range, 133 
regexp-rep, 133 
regexp-search, 135 
regexp-search-disjoint, 134 
regexp-seq, 132 
remainder, 40 

core expression language, 53 
result node list type, 148 

(See Also node-list) 
reverse, 33 

core expression language, 53 
root, 6, 175 
round, 40 

core expression language, 54 
rsiblings, 113 
rule, 264 
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Scheme programming language, 28 

score, 259 

scoring, 259 

script, 272 

scroll, 280 

select-by -attribute -token, 150 
select-by-class, 117, 150 
select-by-missing-property, 118, 150 
select-by-null-property, 117, 150 
select-by-property, 117, 150 
select-by-relation, 150 
select-each, 103 
select-elements, 129 
select-grove, 151 
select-tokens, 131 
sequence, 267 
SGML property set, 59 
sgml-document-address, 283 
side-by-side, 234 
side-by-side feature, 234 
side-by-side-item, 235 
side-effect free, 51 
side -sync, 215 
sideline, 246 
sideline feature, 246 
simple-page feature, 201 
simple-page-sequence, 201 
sin, 40 

singleton node-list, 100 

(See Also node) 
sort-in-tree-order, 115 
sosofo type, 176 
sosofo-append, 183, 267 
sosofo-discard-labeled, 184 
sosofo-label, 184 
source. 111, 131, 
source intrinsic property, 130 
spannable column-subset, 213 
sqrt, 41 

core expression language, 54 
string, 49 

core expression language, 54 
string type, 49 
string>?, 50 
string<?, 50 
string -> keyword, 36 
string->list, 50 



string ->number, 42 

core expression language, 54 
string->regexp, 134 
string-> symbol, 35 
string-append, 50 

core expression language, 54 
string-ci> ?, 50 
string -ci<?, 50 
string-ci=?, 50 
string-equiv? , 50 
string-length, 49 

core expression language, 54 
string-ref, 49 

core expression language, 54 
strings ?, 49 

core expression language, 54 
string ?, 49 

core expression language, 54 
strongly spanning area, 213 
style, 187 
style type, 187 
subgrove, 112 
subgrove-spec, 144 
substring, 50 

core expression language, 54 
subtree. 111 
symbol type, 35 
symbol-> string, 35 
symbol?, 35 

core expression language, 53 
sync, 215 

T 

table, 236 
table feature, 236 
table-auto-width feature, 239 
table-border, 244 
table-cell, 240 
table-column, 238 
table-part, 237 
table-row, 240 
table-unit, 239 
tan, 41 

there-exists?, 102 
time, 52 

core expression language, 54 
time type, 52 
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time>=?, 52 
time>?, 52 
time<=?, 52 
time< ?, 52 
time-> string, 52 

core expression language, 54 
total-node-page-numbers, 220 
transform- grove, 1, 151, 
transform-grove-spec type, 151 
transform- grove-spec ? , 151 
transformation process, 99 
transliteration-map type, 170 
transliteration-map ?, 170 
tree-before, 116 
tree-before?, 116 
tree-root, 109 
truncate, 40 

core expression language, 54 
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union-for-each, 102 
universal code, 9 
unmath, 271 
unquote, 24 
unquote-splicing, 24 
urefnode type, 131 



V 

vertical feature, 195 
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weakly spanning area, 213 
with-language, 49 
with-mode, 191 
word feature, 130 
word-parse, 130 
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zero?, 38 




